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WELCOME TO 
THE OFFICIAL 
MAGAZINE 


t’s always exciting when Raspberry Pi releases 
a new model. The Raspberry Pi 3 Model B+ 
(or Pi 3B+ for short) sports a revised quad-core 
system-on-chip which now runs faster, at 1.4GHz. 

It’s a meaningful speed boost. Everything feels a little 
Snappier. Big programs like Mathematica load faster and 
online videos play more smoothly. 

Raw power is always a headline grabber, but we find 
it’s the other tweaks that make the new Raspberry Pi 
truly interesting. 

Eagle-eyed readers will already have spotted the 
chrome-plating around the wireless networking chip. 
This now supports dual-band (2.4GHz and 5GHz) 
wireless networking, enabling faster data transmission 
speeds from wireless networks. 

Even more exciting is the long-awaited inclusion of 
Gigabit Ethernet (albeit limited via the USB channel). 
There’s now also Power over Ethernet (PoE) via a new 
official HAT accessory. PoE is something the community 
has wanted for a long time; it enables the Raspberry 
Pi 3B+ to be deployed on a network without requiring 
a Separate power supply. 

Many readers are already thinking of quirky uses for 
a networked Raspberry Pi that works independently 
of a mains supply. 

But let’s not forget the speed boost. The new speed 
is impressive. Turn to page 16 to read all about the new 
Raspberry Pi 3B+, including benchmarks, real-world 
testing, and project ideas. 


Lucy Hattersley 
Editor 


a RUme Bay Laspberrypi.org/magpi 


EDITORIAL 


Editor: Lucy Hattersley 
lucy@raspberrypi.org 
Features Editor: Rob Zwetsloot 


DESIGN 


Mage 


4  ~=Available on the 


rob.zwetsloot@raspberrypi.org Illustrator: Sam Alder 
@ App store Sub Editors: Phil King and Jem Roberts 
SS = DISTRIBUTION SUBSCRIPTIONS 
Seymour Distribution Ltd Raspberry Pi Press 
2 East Poultry Ave Mann Enterprises, Unit E, Brocks 
London Business Centre, Haverhill. CB9 8QP 


EC1A OPT | +44 (0)207 429 4000 magpi.cc/subscribe 


Critical Media: criticalmedia.co.uk 
Head of Design: Dougal Matthews 
Designers: Mike Kay and Lee Allen 


Welcome 


YOUR OFFICIAL 


The 


perfect project Ideas 


SUBSCRIBE 


SEE PAGE 28 FOR DETAILS 


THIS MONTH: 


16 RASPBERRY PI 3B+ 


Learn more with speed tests and team interviews 


40 MAKE A MIDI SEQUENCER 


Create your own drum machine with Raspberry Pi 


94 BUILD A MINECRAFT HOUSE 


Build the virtual house of your dreams in Minecraft Pi 


64 BUILD AMAZING BATTLE ROBOTS 


Win Pi Wars 2018 with our guide to amateur robotics 


Cam Meee Magpi@raspberrypi.org 


PUBLISHING 


For advertising & licensing: 

Publishing Director: Russell Barnes 
russell@raspberrypi.org | +44 (0)7904 766523 
Director of Communications: Liz Upton 

CEO: Eben Upton 


CONTRIBUTORS 

Alex Bate, Brian Beuken, Mike Cook,David Crookes, Gareth 
Halfacree, Magdalena Jadach, Steve Martin, Nicola King, 
Jeroen Peters, Matt Richardson, Bartlomiej Rutkowskim, 
Richard Smedley, Clive Webster 


This magazine is printed on paper sourced from 
sustainable forests and the printer operates an 
environmental management system which has 
been assessed as conforming to ISO 14001. 


raspberrypi.org/magpi 


The MagPi magazine is published by Raspberry Pi (Trading) Ltd., 30 Station Road, Cambridge, CB1 2JH. The publisher, 
editor, and contributors accept no responsibility in respect of any omissions or errors relating to goods, products or 
services referred to or advertised in the magazine. Except where otherwise noted, content in this magazine is licensed 
under a Creative Commons Attribution-NonCommercial-ShareAlike 3.0 Unported (CC BY-NC-SA 3.0). ISSN: 2051-9982. 


April2018 MagPi = 3 


( 


Issue 68 April 2018 raspberrypl.org/magp! 


COVER FEATURE 


> PI 101 — INSTALL UBUNTU 38 


How to use Ubuntu on Raspberry Pi 


> BUILD A DRUM SEQUENCER 40 


Pi Bakery is back with another MIDI music project 


> SET UP A DOCKER CONTAINER 48 


Install Plex and learn about Docker in the process 


> AUTOMATE A DESK FAN 02 


The Pi Fan is a temperature-controlled USB fan 


> MAKE A HOUSE IN MINECRAFT 54 


Create a house with the touch of a button 


> MAKE GAMES WITH C PART 4 58 


This time we're manipulating images 


CODE CLUB 
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Official two-day 


MPs, Lords, and kids get their hands on Pi ‘06 
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Wes Streeting MP hosted the 
«~~—s special Code Club event, organised by 
*» Lloyds Banking Group 


Code Club's Dan Powell talking es tec 
with some of the pieieniann ode Club came to was invited to “simulate a Code 


Coppice Primary School Westminster in January, Club in Portcullis House,” says 


to demonstrate how Dan Elwick, Code Club regional 

a Code Club works to MPs coordinator, London & East 
and Peers. The event was of England. 
organised by Lloyds Banking Code Club participated “to raise 
Group, hosted by Labour MP awareness within the Houses of 
Wes Streeting, and Code Clubwas Parliament, as well as to staff in 
invited to take part. Lloyds Banking Group, about what 

Coppice Primary School, from Code Club is, and how it works,” 
Wes’s Ilford North constituency, Dan explains to us. 


Pupils appeared to enjoy the 
pop-up Code Club at Portcullis 
House in Westminster 
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“Politicians were coming in 
during their lunch break,” Dan 
reveals, “and there was a talk 
from Lloyds Banking Group and 
Wes Streeting... I think also it 
was a Special experience for the 
children involved.” 

Hosting the event “over 
the road from the Houses of 
Parliament”, as Dan puts it, 
gave the children of Coppice 
Primary the chance to “come to 
Westminster and experience that 


are held for children aged 9 to 13 
years old — see codeclub.org.uk. 

“So we set the children a couple 
of Code Club projects,” Dan 
reveals. “There was one fairly 
basic project, and then another 
more advanced one. All the guests 
could see the children coding and 
how much they enjoyed making 
things with code.” 

The first project was 
Ghostbusters, “a game where 
you clone lots of ghosts, and 


To raise awareness within 
the Houses of Parliament 
about what Code Club is 


environment.” It also allowed 
politicians to see a Code Club in 
action, and talk to children about 
their coding skills. “Children were 
so excited to be there and the 
MPs clearly enjoyed it too,” Dan 
tells us. “There was a real buzz in 
the room.” 

The event ran for an hour and 
a half, over a lunchtime. In that 
time the 28 pupils from Coppice 
Primary created one of two games, 
based on Code Club projects. 


Playing politics 

The children were a “mixed cohort 
[of] Code Club members and 
selected pupils from years 4, 5, 
and 6”, Dan explains. Code Clubs 
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then ‘click’ to catch them,” says 
Dan. The second was Clone Wars, 
a “Space Invaders-style game, 
where you’re shooting lightning 
bolts at hippos that are falling 
from the sky.” 

Both projects are on the Code 
Club Projects webpage (see 


magpi.cc/unpyFy) and use Scratch. 


MPs and Peers from Parliament 
chatted with the children as 
they worked on their games. 
“The children found that really 
interesting,” Dan confirms. “I 
heard one of the Lords saying 
to the children, ‘And that’s why 
you should all stand for election 
in your local area when you 
grow upl’” 


The event was organised by Lloyds Banking Group, 
and Code Club was delighted to be asked to take 
part. As Sarah Sheerman-Chase, Senior Programme 
Manager, explains, “We've been collaborating with 
Lloyds Banking Group for about 18 months now, 
and they're really keen supporters — hundreds of 
their staff are registered to volunteer with Code 


Club and their colleagues run over 70 clubs.” 


Lloyds Banking Group has its “own, internal drive 
for digital inclusion, and Code Club is key part of 
that initiative,” says Sarah. The scheme is called 
Digital Champions, where over 27 000 colleagues 
have pledged to help people or charities with their 
basic digital skills. It's part of the bank's Helping 
Britain Prosper Plan, which Lloyds Banking Group 
says: “takes us beyond business as usual.” 

It tackles the social and economic issues that 
matter to Britain, such as building digital skills and 
tackling social disadvantage. 

Sarah reveals, “There are around 700 [Lloyds 
Banking Group] colleagues registered with us 
now”, while Lloyds Banking Group “has also started 
a pilot of Code Clubs in some of its branches.” 


Gareth Thomas, a Senior 
Manager at Lloyds, discusses a 
project with two young coders 


April 2018 MagPi 


/'(J1) OPENAUTO: ANDROID AUTO RUNNING ON A RASPBERRY PI 


OPENAUTO: 


ANDROID AUTO RUNNING 
ON A RASPBERRY PI 


Upgrade your car’s navigation and entertainment system 


Above OpenAuto is an Android Auto emulator, allowing your 
Android smartphone to ‘project’ its interface onto your car's screen 


oftware engineer Michal 
Szwaj has released an 
open-source Android Auto 
emulator called OpenAuto, which 
runs on a Raspberry Pi 3. 

Michal’s motivation for the 
project was straightforward: he 
wanted to retrofit his car and use 
Android Auto while driving. “I 
wanted to keep my car’s original 
head unit to preserve the design of 
the dashboard,” says Michal, but 
his car is “14 years old, so its head 
unit is far, far behind the modern 
head units.” 

Thankfully a Raspberry Pi 3 
has “a lot of advantages” for 
OpenAuto, as Michal lists: “It 
is very cheap, [has a] multicore 
processor, hardware video 
decoding, OS based on Linux, 
support for the MCP2515 CAN Bus 
module, and RCA video output.” 
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: OpenAuto runs on a Raspberry Pi 3 
- the microphone is provided via the 
USB sound card 
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Android Auto essentially 
allows an Android smartphone 
to ‘project’ its interface onto 
another screen, but while this 
“sounds trivial,” Michal reveals 
that actually “projection requires 
processing a huge amount of data” 
as the projection system needs to 
display the Android Auto screen, 
play sounds, and relay user inputs 
to the smartphone as quickly 
as possible. 

Michal reveals, “The challenge 
is to handle projection on [a 
Raspberry Pi], where RAM and CPU 
utilisation is very limited and even 
a small bottleneck leads to audio or 
video glitches.” 


In-car entertainment 
Michal continues, “The most 
important thing to implement 
[for successful emulation] was 
support for hardware acceleration 
of video decoding.” 

He tells us, “As far as I know, all 
Android Auto POCs use GStreamer 
to render the video stream.” Alas, 
“GStreamer used on the Raspberry 
Pi does not provide plug-and-play 
support for OpenMAX,” according 
to Michal’s research. This means 
that OpenAuto’s video is “pretty 
slow, even at 480p@3olfps].” 

As such, Michal cannot 
recommend you install OpenAuto 
in your car just yet, but by the time 
you read this, version 1.0 of the 
software should have been released 
for you to trial on a bench. 

Head to magpi.cc/cbSUyr to 
see how to install OpenAuto 
in Raspbian. 
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WINDOWS 
10 UP AND 
RUNNING 


Full-fat Windows 10 
with your Raspberry Pi 


oftware engineer Bas 

Timmer managed to get 

the full, x86 version of 
Windows 10 running on a Raspberry 
Pi 3. But it wasn’t easy. 


Bas tells us that he used both 
standard versions of Windows, 
as well as the ARM64 version, 
to compare codebases. His first 
attempt, to port the “UEFI 
version from the IoT Core” to 


boot into Windows didn’t work out. 


Instead, Bas “added the required 
features to run Windows (ACPI 
tables) to an open-source UEFI I’d 
found for the RPi on GitHub [see 
magpi.cc/guhzUy].” 

After “some days of debugging”, 
Bas managed to get into the 


Windows boot/install environment. 


Unfortunately, the drivers for 


Above Look very closely - that's the 
Broadcom BCM2837 processor of a 
Raspberry Pi listed in Windows 10's 
Device Specifications 

nearly everything were missing, so 
Bas had to write “a hacky driver” 
just to get a USB keyboard to work. 

Curiously, Bas found that 
Windows 10 has support for “a 
special interrupt controller” used 
in the Raspberry Pi’s Broadcom 
processor “that’s not usually used 
in ARM chips.” 

You can read about Bas’s 
progress, and see new updates, 
through his Twitter account 
@NTAuthority. 


FOREVER 


New Raspberry Pi summer festival launched 


his summer sees the 

first Raspberry Fields 

‘community celebration’, 
held in the home of the Raspberry 
Pi —- Cambridge, UK. 

Held over the weekend of Saturday 

30 June and Sunday 1 July, the new 
annual festival is a celebration of 


everything that makers have learnt 
and achieved since the Raspberry Pi 
was launched six years ago. 

The weekend will include 
opportunities to learn about the 
amazing projects that community 
members are working on, try 
activities, watch fascinating 
science and technology talks, 
and generally celebrate all things 
Raspberry Pi and digital making. 

There will also be face-painting, 
fun performances, free giveaways, 
delicious food, and other 
festival-themed activities to get 
involved with. 

The festival will be led by the 
Raspberry Pi Foundation, but run by 


10 | MdgPi April 2018 


cS 
Bc. 


iN 


its volunteer community of young 
people, hobbyists, educators, and 
enthusiasts of any age and skill. 
Tickets cost £5 for over-16s and 
are free for under-16s, bought 
from the Cambridge Junction 
site before arriving. Head over to 
raspberrypi.org/raspberry-fields 
for more information. 


A FESTIVAL OF DIGITAL MAKING 
CAMBRIDGE, UK 


30 JUNE - 1 JULY 2018 


The 


first Raspberry 

Pi festival is 
happening this 
summer, on 
Saturday 30 June 
and Sunday 1 July 
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TABLET 


Simple as an iPad; flexible as a Raspberry Pi 


hinese company 

SunFounder has smashed 

its Kickstarter campaign 
for its RasPad, a10.1-inch tablet PC 
based on the Raspberry Pi. 

With an initial target of just 
£72406, the RasPad raised around 
£22000 in its first hour and, at 
the time of writing, was up to over 
£250 000 — see magpi.cc/huCOtu. 

It’s easy to see why, with an IPS 
touchscreen and a ‘Hatch’ at the 
rear for access to the GPIO pins and 
camera connector. You can even 
use RasPad’s screen as a secondary 
display via its dedicated inputs. 
Prices start at just $129 (£95). 


The IPS screen 
offers iPad-style visuals 
with Raspberry Pi levels 
of hacking and making 
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The stories we shared 
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magpi.cc/cqetsf 
Adding a cellular modem to your Raspberry Pi has 
never been easier - just plug the Nova into one of the 
Pi's USB ports, install the software, and you've got 


yourself an loT device ready to monitor the world. 


Mike Wong, CEO of SunFounder, 
wanted to use the Raspberry 
Pi because “[its] community 
is one of the largest, offering 
lots of useful information and 
open-source resources.” 

The access to the GPIO pins was 
“a necessity” in Mike’s view, given 
how people “buy Raspberry Pi to 
learn hardware programming.” 

Mike confirms, “We wanted an 
all-in-one tablet that’s also useful 
for DIYers... We just want the 
RasPad to serve as a vehicle to see 
where people’s creativity can really 
take them.” 


magpi.cc/kDoAvk 


Artist Stewart Francis Easton created an artwork that 
combined embroidery, music, and a Raspberry Pi 2 
to depict the cycle of life. Elements of the image 
were embroidered using conductive thread, making 
them interactive. 


.. 
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magpi.cc/rwPUCM 


You can now control this robotic face with your 
Raspberry Pi, with a wide range of actions available, 
from head turns to blinking eyes to lip movement. 
The sense of creepiness fades pretty quickly. 
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RASPBERRY 


Detect aurorae, heavy traffic, or meteors on your Raspberry Pi 


rom the makers of the 
Raspberry Shake - a 
seismograph for your Pi 
— comes the Raspberry Boom, a 
device to detect ‘infrasonic’ noises 
undetectable by the human ear. 
While the Shake detects 
movements, the Boom detects 
noises, so it can discern just 
about any event, from avalanches 
and breaking icebergs to lightning 
and transport. 
The sensor detects sound 
waves of 0.05-20 Hz, way below 
typical human hearing. But Mike 
Hotchkiss, consumer marketing 
manager for Raspberry Shake, 
confirms that “the Raspberry 
Boom was designed to be 
operated in your home” - the 


device and software will filter 
background noises. 

You can connect your Raspberry 
Boom device to the Station View 
network to create a global network 
of sensors. Mike also clarifies, “We 
have a few ways for users to grab 
the data in real-time 
and integrate into 
their own websites,” 
Full details are at 
magpi.cc/jJBvsM. 

The Raspberry Boom 
is being launched via 
Kickstarter, so head to 
magpi.cc/cadepc for pricing 
and more information. 


The Raspberry Boom detects 
extremely low-pitched noises, allowing 
you to detect almost anything 


FARNELL LAUNCHES 


CLOUDIO 


IoT meets app-like simplicity 
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raspIO’s Cloudio add-on 

board has a huge range 

of hardware and sensors 
to make your first steps into loT a 
breeze. It’s even programmed with 
a drag-and-drop (Scratch-like) 
interface, so you can set up your 
device from your phone. 

With voice, IR, light, and 
temperature sensors built in, 
you ve got plenty of IoT abilities 
baked in to the Cloudio board, 
including a 0.96-inch OLED 
display. But there are also three 
ADC ports, a mini servo-motor 
port, and three digital output ports 
to incorporate extra abilities. 

The app also supports 
IFTTT integration, a sensor 
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Above GrasplO's 
Cloudio makes 

it simple to build 
and programa 
sophisticated loT 
device in minutes 


monitor, dashboard, and 
custom notifications. 

Hari Kalyanaraman, Farnell’s 
global head of emerging business, 
tells us, “Graspio Cloudio is aiming 
to make things simple for those 
people with little or no coding 
experience to create applications... 
The goal was to make it easy for 
anyone to build IoT projects and 
get up and running in minutes.” 

The Cloudio board costs £33 
from magpi.cc/XbghhF, and is 
compatible with all versions of 
the Raspberry Pi. 
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| ft OpenCat 
uses an Arduino to 
handle the robotics, 
and a Raspberry Pi 
to provide higher 
functions such as 


Alexa support 


An early 
iteration of OpenCat, 
using modelling sticks 
to make the body 


OpenCat pounces to replace 
man’s best friend 


hinese roboticist Rongzhong Li has created a =m C f= » 4 i E Ey 


robotic cat from scratch, including realistic 
movements and Alexa integration. N Dp US T RiitIeE# Ss 
Rongzhong started with some modelling sticks 
and a Raspberry Pi beginner kit, all of which is “still 
integrated somewhere on the cat,” he tells us. You can 
see OpenCat’s evolution at magpi.cc/ZWYGKy. The 
maker wanted to use a Raspberry Pi to power OpenCat 20+ new pr sieets for your P i robot car. 
because of the “easy access to hardware interfaces ae . 
under a Linux environment” rather than the Pi being | 
“a tiny and cheap computer.” 


Gaited development 
Rongzhong studied many mammalian gaits, and believes 
“different gaits can be generated by simple tuning 
amplitude, phase duration, and other tiny parameters”’. 
OpenCat is “not constrained by [being a] cat.” +. oe a 
He found that he had to use an Arduino ‘slave’ to R rl ckP i 3 
handle the robotics, while the Raspberry Pi handles Se ae rie 7 res 
higher functions such as the Alexa integration. LEGO MINDSTORMS + RASPBERRY PI 
Currently, OpenCat uses Alexa “to trigger certain 
behaviours,” but there are also references to ‘hosting 
video streams’ through OpenCat. As Rongzhong says, 
voice assistants “can now run on a pet-like body, and 
interact with people in a pet-like manner. [This] may 
encourage more people to embrace robotics at home.” 
Rongzhong is currently developing ways to make 
OpenCat financially self-supporting — whether that . 
means selling OpenCat kits or something else, we’ll www.dexterindustries.com 
have to wait and see. 
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pi-top 


Inspiring inventors and creators to 


seek the skills of tomorrow and 
create their future, today. 


The modular laptop with sliding keyboard 


SHR BATTERY 14” FULL HD 18 CUSTOM 
LIFE 1080P SCREEN HINGE PASSIVE COOLING 


BRIDGE 


The modular desktop 


4” FULL HD MODULAR ADJUSTABLE 
1080P SCREEN RAI VIEWING ANGLES 


pi-topPROTO 


© www.pi-top.com 


pi-topSPEAKE! 


© @GetPiTop 


pi-topPULSI 


@ /GetPiTop 


pi-top 
Colors 
Raspberry Pi 3 optional 


AWESOME INVENTOR’S KIT INCLUDED 
20+ projects 
to explore 


Explore beyond the screen and keyboard by 
creating with the all-new pi-top modular Laptop. 


Get started with 20+ inventions in the inventor's 
guide booklet. There are 3 inventor's journeys - 
Smart Robot, Music Maker and Space Race. 


pi-topCEED 


Colors 
Raspberry Pi 3 optional 


pi-topCEED is the plug & play modular 
desktop. It's the easiest way to use your 
Raspberry Pi. We've put what you love 
about our flagship laptop in a slimmer 
Form factor. Join hundreds of code clubs 
and classrooms using pi-topCEED as 
their solution to Computer Science and 
STEAM-based learning. 


Modular 
Accessories 


Stay up to date with our latest news by following our social media 
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pi-top is an award-winning ecosystem designed to make 
experimenting, coding and building electronics, simple, 
affordable and fun. pi-topOS is here to guide you through 
the world of making! 


The OCR® endorsed pi-topOS (Operating system) platform 
comes pre-installed on the SD card shipped with every 
unit. pi-topOS software suite Lets you - browse the web, - 
check emails, - create and edit Microsoft Office 
compatible files. Gain access to dozens of hands-on 
learning Lesson plans with pi-topCODER and have fun 
learning to code with CEEDuniverse! 
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CEEDuniverse 
. 


pi-topCODER has a fully 
integrated coding environment 
Letting you program hardware, 
code in Python and Learn Lots 
of STEAM skills! Our integrated 
test framework gives you the 
ability to assess your own 
understanding as you learn. 


CEEDuniverse 


Learn programming concepts 
through our minigames, 

for example, learn problem 
decomposition by solving 
visual programming puzzles. 


Feature 


The newest Raspberry Pi is here! 
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he concept of ‘plussing’ 
T is common at the Walt 

Disney Company. It was a 
term coined by Walt himself; the 
act of looking at an idea or project 
in development and wondering 
how they could make it better 
still. It’s what helps make the 
‘Disney Difference’. 

Raspberry Pi has taken the 
original Pi 3 and plussed it to 
make it better still, in the form of 
the new Raspberry Pi 3 Model B+ 
(or Pi 3B+ for short). Taking the 
design and features to their logical 
conclusion in terms of power 
and speed, the new Pi 3B+ is the 
ultimate Raspberry Pi so far. 

Join us as we explore the most 
magical computer on Earth. 


UK 


€2:pirut The Pi Hut 


magpi.cc/zVIpyC 


Forthings.io 
magpi.cc/KYJbMi 


eiymoORon Pimoroni 


magpi.cc/LhuKdS 


CPC 
magpi.cc/algkOF 


aD pis, Pi Supply 

w nom magpi.cc/LktvfU 
ModMyPi 
magpi.cc/rMXCsW 
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RS RS Components 
magpi.cc/nDkZGZ 
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MEET THE 
RASPBERRY PI 3B+ 


A plus in the name hides a wealth of new hardware 
and design tweaks in a classic footprint 


Running at 1.4GHz, 
the revised system- 
on-chip (SoC) design 
includes brand-new 
package technology 


Shielded under a metal 
plate, the new radio module 
includes dual-band 2.4 GHz 
and 5 GHz WiFi compatibility 
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Designed by Proant, 
the new ground- 

plane antenna offers 
improved performance 
over the Raspberry Pi 
3B+'s chip antenna 


Broadcom BCM2837Bo 
quad-core A53 (ARMv8) 
64-bit @ 1.4GHz 


GPU: 
Broadcom VideoCore IV 


Networking: 
Gigabit Ethernet, 2.4GHz and 
5 GHz 802.11b/g/n/ac WiFi 
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RAM: 
1GB LPDDR2 SDRAM 


Bluetooth: 
Bluetooth 4.2, Bluetooth Low 
Energy (BLE) 


GPIO: 
40-pin GPIO header, populated 


Storage: microSD 


Ports: 

HDMI, 3.5mm analogue 
audio-video jack, 4x USB 

2.0, Ethernet, Camera Serial 
Interface (CSI), Display Serial 
Interface (DSI) 


Dimensions: 
82mm x 56mm x19.5mm 


Weight: 50g 


‘ ~> 
—. 
The new USB and 
network chip features 
Gigabit connectivity, 
considerably boosting 
Ethernet throughput 


An optional Power-over- 
Ethernet (PoE) HAT module, 
available separately, can 
power the Raspberry Pi 3B+ 


Aclever power 
management integrated 
circuit (PMIC) replaces 
discrete components and 
provides smoother power 


Feature 
QUICK SETUP 
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Download an operating system 
You’ll need an operating 

system, available from 
raspberrypi.org/downloads, to use 
your new Raspberry Pi. Raspbian, the 
Foundation’s official operating system, 
is the best choice for most users. 
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Flash to microSD card 

Install the operating system — a process 
known as ‘flashing’ - onto a high-quality 
microSD card of at least 8GB (Raspbian 
Lite) or 16GB (Raspbian with Desktop). 
The easiest way is to use the tool from 
etcher.io and follow its three steps. 


Connect the cables 

Insert the microSD card, then begin 
connecting cables. For most users 
these will include an HDMI display, a 
USB keyboard and mouse (or Bluetooth 
receiver for them), an Ethernet cable 
(optional), and finally a 2A or higher 5V 
micro-USB power supply. 
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feature 


The promise of improved performance is one thing, but there's 
only one way to get to the truth of the matter: benchmark testing 


ith an upgraded processor 
boasting impressive new 
packaging and improved 
networking capabilities, the 
Raspberry Pi 3B+ should sit 
head and shoulders above its 
predecessor the Raspberry 
Pi 3. To determine whether these 
improvements are noticeable in 
the real world, the Pi 3B+, along 
with the Pi 3 and a range of other 
board models, have been put 
through a series of benchmark 


Higher is better 


Driving the GPIO pins via Python 

can result ina CPU bottleneck, as 
demonstrated by this simplest of 
programs: a pin is switched on and off 
as quickly as possible while connected 
to a frequency counter. Note that 
updates to the GPIO driver and Python 
itself will alter these results. 


Lower is better 


A synthetic benchmark designed 

to stress the central processor, 
SysBench's CPU test highlights the 
performance gains available to CPU- 
bound applications - in particular 
those which can take advantage 

of the multiple processing cores 
available on the Pi 2, Pi 3, and Pi 3B+. 
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tests, measuring everything from 
raw CPU performance to power 
draw and WiFi signal quality. 


Although it’s the same underlying 
design as on the Pi 3, the Pi 3B+’s 
BCM2837 system-on-chip (SoC) 
is now in spin Bo and features 
improved packaging alongside 

a heat-spreader, which have 
helped boost its performance 
from 1.2 GHz to 1.4 GHz. This has 


ME FREQUENCY (kHz) 


62.32 
43.07 42.63 


58.55 


a knock-on effect on memory 
performance, too, while the 
new USB Ethernet controller 
offers Gigabit connectivity 

at a theoretical maximum 
throughput of 300 Mbps, due 
to its use of a single USB 2.0 
channel. Finally, a switch toa 
new dual-band radio module 
and antenna design inspired 
by the Pi Zero W improves the 
Pi 3B+’s connectivity compared 
to its predecessor. 


181.9 


48.75 £2.62 


ModelA ModelB Zero Zero W Model A+ Model Bt Pi2 
Raspberry Pi 
343.06 
339.21 


ModelA ModelB Zero 


Zero W- Model A+ Model Bt+ 


Pi 2 
Raspberry Pi 


311.5 


264.5 


Pi 3 


Pi 3B+ 


MM SINGLE-THREADED (SECS) 


/ ; 


139.22 


119.22 


Pi 3B+ 


Pi 3 
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Higher is better 


Not all applications are limited by 
available CPU performance, with 
some reliant on memory throughput 
- the speed at which data can be 
written to and read from RAM. The 
SysBench memory test carries out 
repeated 1kB reads and writes then 
reports the throughput in megabytes 
per second (MBps). 


Higher is better 


The Ethernet port, which connects 
via a shared USB channel, has been 
the last feature of the Raspberry Pi 
design to receive an upgrade. This 
test copies an incompressible 100MB 
file to each Pi on test, and there's no 
surprise in seeing the Pi 3Bt's Gigabit 
Ethernet topping the chart. 


Higher is better 


A head-to-head shoot-out between 
the Pi 3's single-band 2.4 GHz WiFi 
radio and chip antenna and the Pi 
3B+'s new dual-band 2.4GHz and 5 GHz 
radio with ground-plane antenna 
offers a look at the improvements you 
can expect in both signal quality and 
number of visible access points. 


Lower is better 


More performance is always welcome, 
but there's no such thing as a free 
Lunch. This test, which measures 
power draw at the desktop with an 
HDMI display, wireless keyboard, 

and - where applicable - Ethernet 
connected, shows how an older model 
of Pi may be better suited to battery- 
powered and embedded applications. 
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314.31 
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Raspberry Pi 
212.9 


BE THROUGHPUT (Mbps) 


89.19 
84.58 89.08 
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Raspberry Pi 


MP1 38+ SIGNAL QUALITY 


Cell Number 
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Pi 3B+ 
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Eben Upton, co-creator of the Raspberry Pi and co-founder of the Raspberry Pt 
Foundation, delves into the technology that makes the new Pi 3B+ special 


hen working on a new 
W Raspberry Pi design, 

there’s one thing Eben 
Upton always keeps clear in his 
mind. “It’s a Raspberry Pi, so it 
costs $35,” he laughs. 

Delivering constant 

improvements without increasing 
the price is a challenge, but one 
the Raspberry Pi Foundation 
welcomes. “Over time, there are 
a couple of things that help,” 
Eben explains. “One is obviously 
a Moore’s Law thing [the 
observation by Intel co-founder 
Gordon Moore that the number of 
transistors on a new chip doubles 
every 18 months], where you can 
genuinely get more silicon for 
your money. That particularly 
applies to RAM: DRAM [dynamic 
random access memory] has gone 


through probably four or five 
process shrinks between Pi 1 and Pi 
3B+. I don’t think we’re spending 
significantly more on RAM now, 
despite having quadrupled the 
amount of RAM in the device. 

“The other thing is a gradual 
increase in the amount of silicon 
we can put in the design. More 
and more of the BOM (the bill 
of materials) is silicon, and the 
reason for that is that the cost of 
manufacturing Raspberry Pi keeps 
going down because of automation. 
There are still investments going 
on in automation now that are 
taking costs down. The other thing 
is connectors: I pay a lot less for an 
HDMI connector than I used to, and 
that’s just economies of scale.” 


a 
A 


” 


“If you sit still and 


think about it, it 

just doesn’t seem 
real,” says Eben 

Upton regarding the 
Raspberry Pi'’s success 
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feature 


The Pi 3B+ offers boosted WiFi is hard to do,” reveals Eben. 
performance, some of which is “The reference PCB layouts assume 
explained by the new packaging a higher level of PCB technology 
technology, but not all. “While than we have. You can’t just get 
most of the frequency uplift comes the reference PCB design and use 
from the changes we made to the it, because it’s not on the right 
Broadcom part, the new Power PCB technology, so getting a PCB 


The cost of manufacturing 
Raspberry Pi keeps going 
down because of automation 


Management Integrated Circuit is design that was implementable 
quite a substantial contributor to it, and still had the requisite signal 
by reducing the extent to which we integrity and stuff required to do 
need to margin for the regulation conformant 5 GHz was really fiddly 
accuracy and load-step.” and required a bunch of iteration. 


The overhauled networking 
was trickier to implement. “5 GHz 
The original Pi 3 isn’t going away, 
though. “It'll be sold alongside it,” 
explains Eben. “I expect the 3B+ 
will replace it for most consumers, 
there’s not much reason to buy 
a Pi 3 if you have a Pi 3B+, but for 
industrial use it’s a bit different 
because you’ve got people who 
have designed the Pi 3 into stuff. 
“We’re always surprised by the 
long tail of old products. You know, 
we still sell the Raspberry Pi 2. 
I don’t know, we probably sold 
100000 Raspberry Pi 2s last year, 
something like that, so there’s 
always that long tail, and I think 
that tail is going to be longer and 


Roger Thornton designed the : : a) 
Raspberry Pi 3B+ board, having previously thicker for the Pi 3 than it's been 
worked on the Pi Zero W for any previous product.” 
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A3D 
rendering 
highlights 
the ‘vias’ that 
connect layers 
of the Pi 3B+ 
circuit board 


Conformance 
testing for 

5 GHz WiFi was 
a challenge for 
the new radio 
hardware 
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Is the 3B+ your first Raspberry Pi? Here's what you need to know... 


veryone’s got to start 
F somewhere, and if you’ve 
ever seen the rate Pi boards 
are sold we’d hazard a guess that 
the 3B+ will be someone’s first 
Raspberry Pi. If so, welcome to 
the community! We’ve got some 
great tips on where to start on your 
erand Raspberry Pi adventure. 


More on 
your ft 


ul 
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Plugging in an Ethernet 

cable is easy and the 

only problem you’ll 

tend to encounter 

is not having a long 

enough cable, in which 

case you’ll have to connect 

using the Raspberry Pi’s built-in 
wireless capabilities. This is very 
easy in Raspbian - simply look in 
the top right-hand corner for the 
wireless symbol... 


eI =| 0%)/100/ 


Click on it and select your WiFi 


name. It will ask for your password 


and then automatically connect 
from now on! 


It’s a good idea to change the 
default password on Raspbian. 
It’s raspberry just so you know. 
As all Raspberry Pis come with 
a standard password for the 
standard user name (pi), it means 
other people can more easily 
access any secret or sensitive files 
on your Raspberry Pi. 

Changing the password is 
very easy, though. Go to the 


Terminal and then type passwd 
and hit ENTER. Enter the current 
password (raspberry) and then 
enter your new password. That’s it! 
You can also add a new 
user name to use instead of the 
default one if you wish. Check out 
the full guide on the Raspberry Pi 
website: magpi.cc/WlunZG. 
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In a few tutorials you’ ll find for your 

Raspberry Pi online, they’ll ask you 

to do the majority of the work in the 

Terminal. You can either do this on 

the Pi, or by controlling it remotely 

from another computer via SSH. 
SSH is turned off by default 

on the Raspberry Pi, but it can 

be turned on a couple of ways. 


Once you’ve set up 
your Raspberry Pi, 

go to Raspberry Pi 
Configuration in 

the Menu under 
Preferences. Go to the 
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Interfaces tab and click Enable next 
to SSH. After a reboot, you’ll be 
able to connect to your Raspberry 
Pi via SSH - on Windows you 
can use software called PuTTY 
(magpi.cc/xOaGBD). You’|l just 
need to enter pi@raspberrypi as 
the host name and click Open. 
You can also drop an empty file 
named ssh into the boot partition 
of the Raspbian microSD card to 
enable SSH automatically. Note: 
unless you have connected the 
Raspberry Pi to a wireless network, 
you’ll need a wired Ethernet 
connection to SSH in to it. 
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Everything a total 
newcomer needs 
to know is found in 
issue 65, available 
asafree download. [ss 
> cor 
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Here are some projects that can be made better with a Pi 3B+! 


April 2018 


A 
> 
The eight queens problem is 
one that’s tricky to solve as it 
requires you to check many, many 
permutations. The tutorial we’ve 
published previously (in issue 
#65) has been streamlined so the 


Raspberry Pi can run it a bit better. 


Now with the extra power, you can 


make the code a bit more complex. 


Can you win the big prize? 


> 


> 

While old computers and consoles 
are far less powerful than a 
Raspberry Pi, emulating them 
properly uses up a lot of processing 
power. With the extra oomph the 
Pi 3B+ provides, true emulation is 

a step closer on the Raspberry Pi. 


The original version of this project 
uses a Raspberry Pi Zero to do 
some data crunching. Its creator 
Scott Edenbaum has tested his 
setup on a Pi 3 before, saying it 
takes about two hours to build on 
there and even longer on the Pi 
Zero. With the extra power the 3B+ 
affords, can it be done in under 
two hours? 


A 


> 

Image editing uses up a fair 
amount of resources. While 
Mirage on a Raspberry Piis a 
bit less power-hungry than a 
50-layer Photoshop project, 
having a higher CPU speed to 
render or make changes can 
be very handy to help speed 
up your workflow 
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> 
Data analysis can take a while, 
especially if you’re getting a 
lot of data and you want to doa 
large amount of processing on it. 
While even the Pi Zero is capable 
of doing some simple analysis 
quickly, as soon as you begin 
scaling it up you start to require 
a little more power. 


A 


> 
This one can make use of both the 


Raspberry Pi 3B+’s extra processing 


power and enhanced network 


connectivity to perform better than 


ever before. Even the improved 
wireless helps out here! 


> 


> 


The OctaPi is a cluster computer 
using eight Raspberry Pis. Hence 


the name. Pooling the Pis’ 
resources together helps you 


calculate faster, especially when 


it comes to irrational numbers 
like 1 (pi). What’s better than 


eight Pi 3s¢ Eight Pi 3B+ boards. 
Time to set some speed records. 
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De 
> 
The improved network speeds 
of the Raspberry Pi 3B+ make it 
much better suited for being a 
file server than ever before. It’s 
a pretty simple setup as well, 
so it’s worth trying out if you’re 
thinking of how to centralise 
all your files on your network. 


v 
> 
Logging data from the Sense HAT is 


fairly easy for the Raspberry Pi to do. 
So why not use the spare processing 


power to do something useful with 
the data? Create a live analysis or 
crunch any numbers: It’s always 
good to multitask if you can. 
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v 
> 
While similar to the LAMP server, this one is 
a bit lighter, meaning it uses fewer resources. 
Using the Raspberry 
Pi 3B+, you can max 
out your efficiency 
with a server 
running Flask, and 
even use your Pi 
3B+ for other stuff 
in the meantime. 


Discover more 
inspirational 
projects for 
Raspberry Pi 

in The Official 
Raspberry Pi 
Projects - 
Volume 3 book. 
> 
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YOUR OFFICIAL RASPBERRY PI 


Pi Zero W 


Pi Zero W case 
with three covers 


USB and HDMI 
converter cables 


Camera Module 
connector 
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Since it relies on a webcam rather 
than a source, this system works 
regardless of what's being shown, 
whether a film or game. 


The colours around the edge of 
the screen are detected by the 
camera and processed so that the 
LEDs can match them 


| 
It doesn't matter where the camera ye / 


» The software, 
Ambient 
LightServer, is 
open source 


> One part runs 
ona Pi, the 
other on PC 


» The WS2801 
LED lights cost 
just £19.99 


>» You can 
adjust colour 
saturation and 
brightness 


> Jimmy plans 
to add an IR 
sensor for 
remote power- 
up/down 
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is located in the room - it just needs er = =, OS 

a full view of the screen without 


glare or reflections 
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V LIGHTING 


As well as reducing eye strain, the ambient lighting surrounding 
Jimmy White’s goggle-box is rather eye-catching. 
David Crookes takes a look 


ot much beats curling up 

on the sofa with a lovely 

cup of tea and a gripping 
box set, but there is a slight chance 
that you’1l become square-eyed 
by the time the credits roll. It’s a 
well-known fact that watching too 
much TV, especially in the dark, 
puts a Strain on your peepers. Yet 
while backlighting a television set 
helps enormously by increasing the 
amount of ambient light around 


the screen, dedicated TVs which do 
this can prove rather expensive. 
Realising that and already 
owning a decent smart TV, Jimmy 
White decided to make his own 
light setup using a Raspberry 
Pi 3, a USB camera, and some LED 
strips. He wanted to produce a 
bias lighting effect that took into 
account whatever he was watching 
or playing, adjusting the colour of 
the lighting to match the screen. 


“T was inspired by the standalone 
ambient light offerings I have 

seen on the market, but they all 
required the ‘source’ to be external 
to the TV, which did not meet my 
requirements,” he says. 


Watching videos 

Jimmy began the project by 
scouring YouTube for ideas. “I’d 
seen many videos where people 
were using Arduinos to drive LED 
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Above Jimmy created a test card so 
that the screen could be calibrated via 
AmbientLightPyClient on a PC 


Strips, but they all depended on 
the external HDMI source,” he 
explains. “I eventually came across 
a piece of open-source software 
written especially for the Pi on 
GitHub and it was just the thing 

I was looking for.” 

The software, AmbientLightServer 
by Waldo Bronchart 
(magpi.cc/gZLhHv), works by 
capturing colours from the edge 
of a television screen using a 
webcam. It then uses the data it 
gathers to update any attached 
LEDS with those colours. It works 
very well but Jimmy had to tweak it, 
editing the number of LEDs in the 
strips, adding the location of the 
Starting light and creating an install 
script (magpi.cc/rnrwEW). 

He also worked with a companion 
app called AmbientLightPyClient, 
which runs on a PC and allows 
the edges of the screen to be 
defined and the colour saturation 
and brightness to be set. The 


The camera detects the colours 


LET THERE BE LIGHT 


the LEDs went in relation to the 
screen,” he recalls. “Having a strip 
running lin] the wrong direction, 
orientation, and position was 
rather confusing.” He used hook- 
and-loop fasteners to stick the 


around the edge of the screen 
and adjusts the LEDs to match 


parts list, however, was more 
straightforward. Jimmy already had 
some Raspberry Pi 3s (“I wanted 

to make use of them as a low-cost 
solution,” he says), a16GB memory 
card, and a Logitech C270 webcam, 
so he set about buying the LEDs and 
some 18-gauge electrical wire. 


Wiring up 


“The most difficult part was 
trying to work out which direction 
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LEDs to the back of the set in the 
most unobtrusive way and he 
tested they worked by creating 
his own four-colour ‘test card’. 
This was displayed on the screen 
and the camera was pointed so 
that it could capture the display’s 
full view. 

“The camera detects the colours 
around the edge of the screen 
and adjusts the LEDs to match.” 
Jimmy reveals. Indeed, it captures 


AMBIENT TV LIGHTING 


Setting it up 

The Pi 3 runs AmbientLightServer, 
driving the LEDs. A Python Qt client 
app called AmbientLightPyClient 
runs on a PC and connects to it. The 
sampling region and colour settings 
can be controlled. 


>STEP-03 © 


Above The power and data wires are 
soldered to the Raspberry Pi 3 and the 
software was installed to a 16GB card 


frames at a low resolution and 30 
frames per second, which makes 
the system quite responsive. The 
effect of this is a more pleasurable 
television experience, one which 
gives the appearance of extending 
the screen into the room. “It looks 
really cool,” Jimmy concludes, 
rather pleased with the result. 
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The Joy-Cons are used to control 
the games. After much struggle, 
Christopher managed to get the 
analogue sticks working 


>» The Joy-Cons 
can be used 
for two-player 
gaming 


>» PiSwitch boots 
to Chris's own 
touchscreen 
menu 


> The 6600 mAh 
battery offers a 
2.5-hour life 


>» PiSwitch 
can also be 
plugged into 
alTV 


» An optional 
camera was 
added for fun 
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The 3D-printed case holds the Pi 
3 and other components and it 
includes the locking mechanism 
for the Joy-Con controllers 


The 7-inch Raspberry Pi Touch 
Display is at the heart of the 
project, which also makes use 
of RetroPie for emulation 


WITCH 


New meets old in Christopher Foote’s take on the retro-gaming 
handheld console thanks to Nintendo’s latest innovative controllers. 


David Crookes reports 


ne of the most popular 
things to do witha 
Raspberry Pi is to put it at 
the heart of a retro gaming setup. 
There are myriad multi-system 
emulators — programs which 
replicate the gaming systems 
of old - along with some slick 
eraphical front-ends, making 
it arather straightforward 
process. But we still see projects 
that go the extra mile such as 
this one. PiSwitch makes great 
use of the Joy-Con controllers 
of the Nintendo Switch 
console to produce a beautiful 
handheld machine. 
PiSwitch is the brainchild of 
SJaycdie Old Chbisvopmen Poole 
who, as a child, would get one 


game a year to play (“two if I 
was lucky,” he says). He recalls 
spending countless hours trying 
to accomplish everything he 
could in those titles. “But there 
were always many games that I 
wanted to play but I couldn’t,” 
he laments. 

Spurred on by this, he began 
using RetroPie a few years ago to 
enjoy games made for systems as 
diverse as the Atari 2600 and Mega 
Drive. But although he ran itona 
Adafruit’s PiGRRL2, he found the 
buttons were sticky and he didn’t 
like the screen. “Then my wife got 
a Nintendo Switch for my son and 
when | played with it I realised 
the controllers were exactly what I 
needed for my device,” he tells us. 


Having discovered the Switch 
Joy-Cons were Bluetooth devices, 
Christopher got to work pairing 
them with a Raspberry Pi. “I spent 
a lot of time trying to connect 
two of them to work as a single 
controller and I thought if I could 
SOlve Uma jocolo) ein, Ure Une RESiL 
would be a cakewalk,” he says. 


Mapping controls 

He compiled Linux Joystick Mapper 
on his Pi 3 before mapping the 
controllers to keyboard Keys and 
mouse buttons. “It worked great 
apart from the analogue sticks, so 

I looked through the code for a few 
hours, figured how Linux Joystick 
Mapper worked, and reprogrammed 
it for Joy-Con compatibility.” 
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Knowing his project was 
possible, he could then get to 
work on refining it. He soldered a 
headphone jack to the Raspberry 
Pi so that he could listen to the 
games when commuting. He 
then sought to boost the battery 
life by soldering a power board 
and switch. A speaker was also 
added, along with a Pi V2 Camera 
Module (although this, he admits, 
was optional and included for 
fun). A case was printed and the 
components assembled inside 
before a 7-inch touchscreen 
was added. 


Fitting perfectly 

One of the lovely parts of the build 
is the way the Joy-Cons click into 
place to the left and right of the 
screen, just like on a Nintendo 
Switch. “I took my Switch and 


The side of the case has been 
designed so that the Joy-Cons 
can lock into place 


load different controller maps.” 
This ensures they work well with 
retro games whether as a single 
controller or separate ones, 

but also as a mouse or to flip 
through media on Kodi, which 
he also installed. 


I realised the controllers were 
exactly what I needed 


a pair of digital calipers and | 
measured the inserts for the 
controllers,” Christopher says, 
getting the fit just right. 

The two controllers make the 
PiSwitch versatile. “I can play 
one-player with both controllers 
to fully emulate a Nintendo 64 
or PlayStation controller,” he 
explains. “The Joy-Cons also 


In the near future, Christopher is 
going to work on refining the case 
and the overall look of the console. 
“Tm also looking to add support 
for streaming via Steam,” he says. 
“T think being able to play games 
from your desktop anywhere in 
the house with the comfort of a 
handheld device would be a really 
cool feature.” 


A. a 7. - _ ie . : 2 - he = 
siege NA a eee, eae A 
. Set. ahd nea: 


The rough 3D-printed case needs 
refinement, but it contains access 
points for the jack, the microSD card, 
and the Raspberry Pi’s HDMI port 
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>» The name 
comes from 
‘QR’ and 
‘crocodile’ 


> It can play 
music ina 
selected room 


> QR codes are 
glued onto 
pieces of card 


» Qrocodile has 
voice feedback 


> It currently 
supports ten 
commands 


Each card hasa 
unique QR code 
on the reverse 
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OCODILE 


A snappy idea, making it easier to control a Sonos multi-room 
speaker system, as Nicola King discovers 


een to find a way to enable 

his young children to 

quickly and easily search for 
and play their favourite music tracks 
on the family’s Sonos sound system, 
Chris Campbell had a brainwave. 
“Usually my kids ask me to play 
certain songs that they already 
know, and then I have to use the 
Sonos app on my phone or computer 
to hunt them down. One night at the 
dinner table I was lamenting how 
many steps are involved in using the 


Sonos apps to search for music or to 
enable the turnable... That’s when 
the seed of an idea was planted.” 

Initially he thought of creating a 
simple button that just enabled the 
vinyl turntable linked to the Sonos, 
but grander plans soon started to 
take shape, centred on the use of 
QR codes. 


Scanning for codes 
Printed on cards, the QR codes are 
read by a mini camera connected to 


a Raspberry Pi 3, housed in a LEGO 
crocodile case. “When my software 
sees a QR code that it understands 
(for example, a code representing a 
music library track), it builds up and 
sends the appropriate request(s) to 
the Sonos system,” explains Chris. 
In addition to playing tracks, some 
of the cards contain commands 
such as ‘Play music in living room’ 
or ‘Build a list of songs’. The 
qrocodile also speaks to you, to tell 
you what it is doing! 


: 


The mini camera 
continually scans 
for QR codes 


The Raspberry Pi interprets the 
code and sends a command to 
the Sonos sound system 
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The cute croc-shaped case is built from his son's green LEGO bricks 


Chris spent around four weeks 
working on the project in his 
Spare time, ironing out several 
issues along the way, such as 
with the QR encoding algorithm. 
His first implementation simply 
encoded the full artist, album, 
and song title metadata in the 
OR code. “This worked fine 
for short names/titles, but not 
so well for songs or albums 
with really long titles. It hadn’t 
OccUined LO mle thal the more 
information you cram into aQR 
code, the tinier those little black 


So, what do his children think of 
their dad’s inventions “They love 
it! My son likes that it allows him to 
be in control of the playlist for their 
dance parties. My daughter enjoys 
being able to play her favourite 
song Starman over and over.” 


No grocodile tears 
So far, no qrocodile-related fights 
have broken out between the kids. 
“They picked up on how to use it 
almost immediately.” 

For those who’d like to build one, 
Chris has supplied full instructions 


QR codes are read by amin 
camera connected toa 


Raspberry P13 


and white squares get. And the 
smaller those squares get, the 
harder it becomes for the camera 
to read.” 

His solution was to apply a hash 
function to the metadata, so that 
only a few characters need to be 
stored in the QR code in order to 
identify a song. “After making 
that change, the QR codes were 
much less fine-grained and could 
be read easily by the Raspberry Pi- 
attached camera.” 
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on GitHub (magpi.cc/CxZOkQ). 
“My grocodile is just one 
incarnation of a concept; I’m 
interested to see what sort of 
tweaks and variations other people 
come up with on their own!” 

Still working on perfecting the 
project, he has plans to add extra 
commands such as a weather 
forecast. He’d also like to explore 
making the grocodile work with 
NFC-embedded cards, and creating 
a smaller version using a Pi Zero W. 
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> The display 
weighs around 
2.5kg 

> 64 pixels are 


rotated into 
view by servos... 


fees ELECTROMECHANICAL DISPLAY 


24 boards 


were Featuring an ingenious rotating pixel design, Gavan Fortune’s 


components 


weoeereeme = electromechanical matrix display is most impressive. 
> It took over two Phil King reports 


weeks of solid 


3D-printing 
time ooking to create a 


decorative project for his Comprising seven 3D parts, As a pixel is rotated, its 


ffi each pixel is turned bya vanes emerge from the 
office party, Gavan Fortune servo at the rear black casing 


decided that a standard LED matrix 
display would be too obvious. 
“Somehow I started thinking about 
electromechanical things like the 
flip-dot display and wondered 
what I could do that would bea 
little bit different,” he tells us. 

The result is the Pixel, an 
amazing electromechanical matrix 
display controlled by a Raspberry 
Pi (magpi.cc/tcMzFz). Each of its 
64 ‘pixels’ is turned on and off bya 
servo rotating a 3D propeller-like 
shape to reveal its bright yellow 
vanes from a black casing. 


Unique design 

“T don’t know of any other 
implementation of this shape for 
a display,” says Gavan. “The idea 
came from the AWS visual display 
(a.k.a. sunflower) in a train cab, 
which in its active state displays 
interleaved yellow and black 
segments, but this was an exercise 
in extending the yellow part to 
cover the whole circle. This is not 
possible to do with a part rotating : Monitor stands add extra 
behind a shutter, and meant that aaah . Andie i 
there had to be a third dimension 

to the moving part.” 
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Unlike in a traditional flip-dot 
display, the 3D-printed pixels 
can be rotated to intermediate 
positions to achieve greyscale- 


from emitting data to the servo 
controllers faster, but the servos 
do take a little while to rotate. 
Too high a frame rate just leads to 


The 3D-printed pixels can 
be rotated to intermediate 
positions for greyscale shading 


style shading. “There are definitely ghosting effects on high-contrast 


things you can do with this display 
that you couldn’t do with a two- 


state display. Perhaps my favourite 


has to be aripple effect.” 

The Pixel display can show 
animations, too. “The frame 
rate is just a few frames per 
second,” reveals Gavan. “There’s 
nothing stopping the software 
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features such as text.” 


Two phases 

In total, from concept to finish, 
the Pixel took Gavan three and a 
half weeks to make, split between 


design and manufacturing phases. 


“The design phase involved 
learning about screw threads 


The rotation of the servo is 
transmitted via two nails to the pixel, 
which moves forward/backward as 
it turns, guided by a screw thread 
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Wiring 
all 64 servos 
took longer than 
figuring out basic 
communication 
with the Pololu 
Mini Maestro 24 
controller boards 


and what can be 3D-printed. 

The first few iterations of the 
design had various problems with 
friction and sticking, which were 
resolved by having two separate 
screw threads — one to drive the 
correct motion and one for the 
display element.” 

Due to time pressure, Gavan 
had to live with a few design 
issues. “The end result is that 
some parts are a bit fragile, 
leading to reliability issues.” 

While much of the design is 
robust, there are two places where 
the pixels are prone to failure, and 
a few have broken. “The fix is quite 
straightforward but does involve 
reprinting four parts per pixel. | 
will probably do that once I have 
run out of spare parts.” 
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Try out this alternative operating system on your Raspberry Pi 


ubuntuMATE "4 
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recommend programs for you to install 
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Tutorial 


> MIDI sound 
generator 


> Four 
potentiometers 
with knobs and 
coloured tops 


> Box for pots like 
the Maplin FT31 


> Stripboard: 
17 strips of 
14 holes 


> MCP3008 
> 16-pin IC socket 


> Bottom-entry 
twin-row 
header sockets, 
24 contacts 
at least 


> 10-pin 
single-row 
header socket 


>1x* 0.1UF 
ceramic 
capacitor 


Make your own nine-channel drum sequencer 


drum sequencer, or drum machine, isa 

Staple part of virtually every music making 

system. Gordon Sumner (who, for younger 
readers, is also known as Sting from the rock combo 
The Police) once joked that the difference between a 
drum machine and a drummer was that you only had 
to punch the rhythm into a drum machine once. So 
we are going to show how to make your own drum 
machine using Python on the Raspberry Pi. 

The MIDI sound module that we made in Pi Bakery 

in The MagPi #63 has a set of percussion voices that 
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The screen layout for the drum sequencer 


we mentioned in passing. These cover both General 
MIDI 1 and General MIDI 2 standards. General MIDI 
(GM for short) is an agreed mapping between an 
instrument number and its description. Before 

the advent of GM, it was down to the equipment 
manufacturer to assign what instrument number 
produced what sound; this meant that to get correct 
MIDI playback you had to use the same sound 
module as was originally used when creating the 
MIDI files. Some sound modules still have their 
own sound mapping, but GM does make things a lot 
more flexible. 

For percussion, things are a little different from 
the normal melodic instruments. Where, if you select 
say a tuba, using program message 59, then the note- 
on-message numbers give you different notes of the 
music scale played on a tuba. With the percussion, 
if you select a percussion bank, the percussion 
instrument you get will depend on the ‘note on’ 
message number. Valid numbers range from 27 to 87, 
so that is 60 different instruments. 

Note here how we said that the sound description 
is Standardised; this does not mean the actual sound 
will be exactly the same. So while in percussion 
a ‘note on’ number of 60 is described as a ‘High 
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This is the MIDI sound 
generator we're using 
in this project 


This board is an ADC, which 
you need for the Raspberry Pi 
to talk to the system 


These parameter adjustment 
knobs change the sound 


Bongo’, how good this actually sounds will change in a sequence and while we have decided to have 16 
from synth to synth. hit points, you can, with a software option, make it 
repeat after the first four or first eight hit points. For 


Design a sequence length of four, the hits are every beat in 
Most drum sequencers generally have the same form _a bar or whole notes. Half notes give you a sequence 
of grid layout: horizontal rows define the firing point length of eight, whereas quarter notes produce a 

in a sequence for one instrument, and these rows length of 16 steps. So the W, H, and Q keys define the 
are stacked for as many instruments as you want number of steps in a sequence. 


to have playing in your loop. The length of the row In addition, you want to be able to select at what 
defines the number of beats or hit points you have point an instrument sounds; for that, the grid 
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Tutorial 


Raspberry Pi 
GPIO connector 


GPIO 10 
GPIO 9 
GPIO 11 
GPIO 8 


Gnd 


3V3 


0.1uF 


>STEP-O1 
Preparing the board 


Take a piece of stripboard 17 strips wide by 14 
holes high, and break the tracks shown by the 
light grey areas (below) with a scalpel or spot face 
cutter. The dotted lines show the positions of the 
IC socket. Most of the board will hang over the 


16 
15 
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13 


10 


MCP3008 


Ic 2 


side of the Raspberry Pi. 
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Volume Velocity Pan Reverberation 


Schematic of the control circuitry 


squares are clicked to select firing or not. You also 
need to start and stop the sequencer. In order to get 
a good mix, you need to be able to control the volume 
and the hit velocity of each instrument, its position 
in the stereo field, known as pan, and also control 
the amount of reverberation applied. This is done by 
using four knobs to adjust each parameter. Only one 
sound can be adjusted at a time, but once adjusted, 
its settings are stored and the next channel can be 
adjusted. The instrument adjusted by the knobs is 
selected by the number keys 1 to 9 on the keyboard, 
with the 0 key locking all instruments against 
change. Coloured lines representing each parameter 
are drawn over on the right of the screen, with each 
colour matching the top of the labelled knob. The 
screen layout is shown in Figure 1 (page 40). 
The/yand + keys.alter the speed of the steps, 
and the C and R keys clear the grid and reset the 
sequence. The I key is when you want inspiration: 
it gives you a Starting point for a rhythm. 


The hardware 

The hardware consists of four potentiometers in a 
box connected to an analogue-to-digital converter 
(ADC) attached to the SPI GPIO pins of the Raspberry 
Pi. We used an MCP3008 eight-channel converter, 


but could have used the smaller MCP3004, as we 

did in the Ribbons project in The MagPi #49. There 

is no need to make this if you don’t want to: there 
are many ready-built ones about. Even the excellent 
RaspPi0 Inspiring LED driver interface board has 
the option to fit this chip. If you do want to make 
one, the schematic is shown in Figure 2 and full 
construction details are in the step-by-step guide. 


Software design 

While we’re using our normal Pygame framework, 
this project posed a bit of a problem when it came 

to selecting the instrument for each track. The 
obvious solution is a menu, but Pygame doesn’t 
support them, especially one with a choice of 60 
instruments, so to get round this we have to be 
Slightly devious. The solution we came up with is 

to use the Tkinter framework to create a very small 
window with just a menu button visible, then clicking 
on that button would open the menu. This produced 
a further complication in that we wanted this menu 
to pop up in the place we clicked. It turns out that 
Tkinter requires a mouse position based on the whole 
screen, whereas Pygame tells you about the mouse 
position referenced to the Pygame window. To get 
round this we had to import the pymouse module, 
which is now part of the pyuserinput package. So we 
had to type into a Terminal window: 


sudo pip-3.2 install xlib 
sudo pip-3.2 install pyuserinput 


The action to change an instrument is to click 
on the existing instrument name, where it will be 
outlined in red. When the mouse is released, the 
menu window appears under the mouse; click and 
hold will bring up the full menu and a release over 
the required instrument selects it. 

As there are a lot of objects to click on, we use the 
rectangle data structure and the rectangle and point 


>STEP-02 
Underside of the board 


Mount and solder the bottom-entry socket to 

the strip side of the board. You need to make 

the joint at the point where the connectors pass 
through the holes to the component side. Also, 
we soldered a surface-mount capacitor between 
the ground and power tracks. Mount the IC socket 
and ten-pin header from the other side of the 
board and solder them to the tracks. 
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>STEP-03 
Wiring up 


Wire up the chip and GPIO socket according 

to Figure 2; a physical representation of this is 
shown below. Note the wire from the power strip 
goes to pin 16 of the chip and carries on under 
the board to pin 15 of the chip. The analogue 
inputs to the chip are in the correct order for the 
header strip. 
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Tutorial 


>STEP-04 


The potentiometer box 


Drill 7mm holes for the shaft of the pots. Then 
push the pots in from the top of the box to mark 
the place for the anti-rotation pip. Use a1mm drill 
or router to make a slot for this pip so the pot sits 
flush. If you must, you can cut off the pip. Wire 

up the pots before mounting them in the box to 
make things easy for yourself. Fit the knobs, tops, 
and labels. Connect to the board as per Figure 2. 


collide function to see what object, if any, has been 
clicked on. 


The software 

The Percussion_sequencer.py listing shows the 
code, and the program is basically running the 
sequencer or not — defined by the variable running. 
In reality the rhythm tracks 1 to 9 are actually the 
MIDI channels 15 to 7. The global reverberation is set 
to a maximum and the local channel reverberation 
is tamed by the controls. The software reads a file, 
percussion.txt, comprising a list of instruments 
called; this is taken from the data sheet of the VS1053 
chip we used for the MIDI sound box, but this project 
will work with any MIDI sound generator. 


Taking it further 

While this is designed for a 4/4 time signature, 

the number of hit points that define the sequence 
repeating length can be changed for alternative time 
signatures. So if you want to play in 15/16 time, say, 
change the variable beat to be set to 15 on the press 
of some key in the checkForEvent function. Another 
useful addition would be a box to the left of the 
screen to mute individual tracks. You could replace 
the variable controls and ADC with key presses that 
increment or decrement the various parameters. 


Percussion_sequencer py 


001. 
002. 
003. 
004. 
005. 
006. 
007. 
008. 
009. 
010. 
011. 
012. 
013. 
014. 


015. 
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017. 
018. 
019. 
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023. 


024. 
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933. 


034. 
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046. 
047. 


# MIDI percussion sequencer with Pots control 
# By Mike Cook February 2018 

import pygame, os, time, random 

import functools, rtmidi 

from pymouse import PyMouse 

from tkinter import * 

import spidev 


midiout = rtmidi.MidiOut() 

pygame.init() # initialise graphics interface 

os.environ[ 'SDL_VIDEO WINDOW POS'] = ‘center' 

pygame .display.set_caption("MIDI Percussion sequencer") 
pygame.event.set_allowed(None) 

pygame.event.set allowed([pygame.KEYDOWN, 

pygame .MOUSEBUTTONDOWN, pygame.QUIT, pygame.MOUSEBUTTONUP ] ) 
textHeight=26 ; font = pygame.font.Font(None, textHeight) 
ScreenWidth = 1100 ; screenHeight = 670 

padXm = screenWidth-100 # maximum X of pads 

screen = pygame.display.set mode([screenWidth, 
screenHeight | ,2, 32) 

instRect = [ pygame.Rect((0,0),(0,0)) for i in range(@,9) | 
# instrument name rectangles 

instNumber = [9, 8, 11, 14, 33, 34, 20, 21, 30] 

# default instrument numbers 

stopRect = pygame.Rect((0,0),(@,8));startRect = 
pygame.Rect((0,0),(0,0)) 

instToChange = @ ; step = -1 3 random.seed() ; showControls 
= False ; controls = @ 

padCols = [(28,28,28), (180,180,0)] ; playCols = 

[ (20, 20, 20), (50, 200, 200) | 

lastStep = time.time() ; running = False ; bpm = 240 

# beats per minute 

potValue = [0,0,0,0] ; beat = 16 ; black= (8,8,8) 


def main(): 
global master 
createMatrix() 
initMIDI() 
loadResource() 
pygame.draw.rect(screen, black, (8,8, screenwWidth, 
screenHeight) ,@) 
drawScreen() 
setBPM(@) 
while(1): 
checkForEvent() 
if showControls : 
readPots() 
if not running : 
time.sleep(@.05) # let other code have a look in 
if time.time() >= (stepTime + lastStep) and running: 
nextStep() 


def nextStep(): 
global step, lastStep 
lastStep = time.time() 
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048. step += 1 @93. midiout.send_message 

@49. if step >= beat: ([@x9@ | ch,instNumber[row]+27, >PYTHON 3 

050. step = @ velocity[row]]) # channel note 

@51. drawLeds(step) velocity DOWNLOAD: 

Q52. drawPads() # wipe out last playing colour e94. magpi.cc/4aNqJjmv 

@53. i a2) @95. def drawControls(): PROJECT 

@54. pygame.display.update() 096. pygame.draw. VIDEOS 

655. rect(screen, black, 

@56. def drawScreen(): Q@97. (padXm-6,2@,screenWidth, 30) ,0) Check out Mike's 

@57. global instRect,stopRect, startRect drawWords("BPM "+str(bpm), Bakery videos at: 

magpli.cc/1NqJnIz 

58. drawLeds(step) Q@98. padXm+80,10,(180,180,0), black) 

@59. drawPads() pygame.draw. 

60. drawControls() @99. rect(screen, black, (padxXm-6,38,4,screenHeight) , 2) 

061. pygame. draw. rect(screen, black, (8,0,184, 100. if showControls: 
screenHeight) , 2) 101. pygame.draw. line(screen, (180,180,8), (padXm- 

062. for lab in range(@,9): 6,40+(controls * 70)),(padXm-6,84+(controls * 7@)),2) 

063. instRect[ lab] = drawwords(iNames[instNumber[lab]] 102. for c in range(@,9): # draw the pot controls 
»176,53+(lab*7@) , (180,180,0) , black) 103. drawPots(c) 

064. if running : 104. pygame.display.update() 

065. startRect = drawWords("Start", 75,18, (0,180,0), 105. 
black) 106. def drawPots(ch): 

066. stopRect = drawWords("Stop",144,18, (180,180,0), 107. SX = padXm+12 
black) 108. pygame.draw.rect(screen, black, (sX,46+ 

067. else: (ch * 70),66,48) ,0) 

068. startRect = drawWords("Start",75,18,(180,180,0), 109. pygame.draw. line(screen, (0,180,0),(SX,47+ 
black) (ch * 70)),(sX+(volume[ch]/2),47+(ch * 70)),2) 

069. stopRect = drawWords("Stop",144,18, (@,180,0), 110. pygame.draw. line(screen, (180,0,0),(sX,57+ 
black) (ch * 70)),(sX+(velocity[ch]/2),57+(ch * 70)),2) 

070. pygame.display.update() 111. pygame.draw. line(screen, (0,180,180), (SX,67+ 

Q@71. (ch * 70)),(SX+64,67+(ch * 7@)),2) 

Q@72. def drawLeds(n): 112. pygame.draw. line(screen, (0,0,180), (SX,67+ 

073. pygame. draw. rect(screen, black, (174,80, (ch * 70)),(sX+(pan[ch]/2),67+(ch * 7@)),2) 
padXm-174, 33),0) 113. pygame.draw. line(screen, (80,80,80), (SX, 77+ 

074. for sq in range (0,beat): (ch * 70)),(sX+(reverb[ch]/2),77+(ch * 70)),2) 

Q75. if n == sq: 114. 

76. pygame.draw.circle(screen, (190, 28, 28), 115. def drawWords(words,x,y,col,backCol) : 
(174+38+(50*sq),20),6,0) 116. textSurface = font.render(words, True, col, 

077. else: backCol) 

078. pygame.draw.circle(screen, (28, 28,28), 117. textRect = textSurface.get rect() 
(174+38+(50*sq),20),6,0) 118. textRect.right = x 

079. ala he textRect.top = y 

@80. def drawPads(): 120. screen.blit(textSurface, textRect) 

081. pygame. draw. rect(screen, black, (184,33, 121. return textRect 
padxm- 198, screenHeight ) , 0) 122. 

082. for row in range(@,9): 123. def readPots(): 

083. for sq in range (0,16): 124. for i in range(0,4): 

084. pygame.draw.rect(screen, 125. adc = spi.xfer2([1, (8+i)<<4,0]) # request channel 
padCols[matrixCont[ row][sq]],matrixRect[row][sq],®) 126. reading = (adc[1] & 3)<<8 | adc[2] 

085. 127. # join two bytes together 

Q@86. def drawPadsC(c): 128. if abs(reading - potValue[i]) > 8: 

Q@87. for row in range(@,9): 129. potValue[i] = reading 

088. pygame.draw.rect(screen, 130. updatePots(i, reading>>3) 
playCols[matrixCont[ row][c]],matrixRect[row][c],®) 131° 

Q@89. if running : 132. def updatePots(num, value): 

990. for row in range(@,9): 133. ch = controls # value of channel we want to change 

e91. if matrixCont[row][c] > @ : #play note 134. if num == @Q: 

@92. ch = 15-row 135. volume[controls] = value 
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midiout.send message([@xBe | 
15-ch,@x@7,volume[ch]]) # set volume 
if num == 
velocity[controls] = 
if num == 
pan[controls] = 
midiout.send message([@xBe | 
15-ch,@x@A,pan[ch]]) # set pan 
if num == 
reverb[ controls] = 
midiout.send message([@xBe | 
15-ch,0x5B,reverb[ch]]) # set reverb channel 
drawPots(controls) 
pygame.display.update() 


value 


value 


value 


def loadResource(): 
global iNames, spi 
nameF = open("percussion.txt","r") 
iNames = [ | 
for i in nameF.readlines(): 
i[:-1] # remove CR at end of name 
iNames.append(n) 
nameF.close() 
Spi = spidev.SpiDev() 
Spi.open(@,@) 
spi.max_speed_hz=1000000 


iq = 


def initMIDI(): 
available ports = midiout.get ports() 
print("MIDI ports available:-") 
for i in range(@,len(available ports) ): 
print(i,available _ ports[i]) 
if available ports: 
midiout.open_port(1) 
else: 
midiout.open_virtual port("My virtual 
output" ) 
for ch in range(7,16): # set up channels 
midiout.send_message([@xBe@ | ch,@x@7, 
volume[15-ch]]) # set volume 
midiout.send_message([@xBe@ | ch,e@x@A, 
pan[15-ch]]) # set pan 
midiout.send_message([@xBe@ | ch,@x5B, 
reverb[15-ch]]) # set reverb channel 
midiout.send_message([@xBe | ch,@xe@,0x78]) 
#set drum bank 
midiout.send_message([@xce | ch,exee] 
# set instrument 
midiout.send message([@xBe@ | 7,@x@C,127]) 
# set global reverb 


def createMatrix(): # create variables 

global matrixRect, matrixCont, volume, velocity, 
pan, reverb 

matrixRect = [] ; matrixCont = [ | 

rowSq = [] 3 cont = [] 

for row in range(@,9): 
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187. 
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192. 
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215. 
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219. 
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221. 
222. 


223. 
224. 
225. 
226. 
227. 
228. 
229. 


t = [] ; c = [] # blank row and contents list 
for sq in range (15,-1,-1): 
t.append(pygame. Rect ( 
(padXm-60-(50*sq),40+(row * 70),46,46))) 
c.append(@) 
matrixRect.append(t) ; matrixCont.append(c) 
volume = [ 127-c*8 for c in range(@,9) ] 
# channel volume 
velocity = [ 120-c*8 for c in range(@,9) | 
# striking strength 
pan = [ 64 for c in range(@,9) ] 
# position in stereo field 
reverb = [ 127-(c*10) for c in range(@,9) | 
# off by default 


def clearPads(): 
global matrixCont, step, running 
for row in range(@,9): 
for sq in range(@,15): 
matrixCont[row][sq] = 2 
running = False 
step = @ 
drawScreen() 


def randomSetup(): 

clearPads() 

for row in range(@,9): 

for sq in range(0,15): 
if random.randint(@,100) > 92 : 
# random chance 10% 
matrixCont[row][sq] = 1 
drawScreen() 


def setBPM(inc): 
global stepTime, bpm 


bpm +=inc 
stepTime = 1/(bpm / 60) 
drawControls() 


def runTk(): 
global master 
master = Tk() 
menubar = Menu(master) 
menu = AutoBreakMenu(menubar, tearoff=@) 
Fil1lMenu(menu) 
menubar.add_cascade(label="Instrument", 
menu=menu ) 
PyMouse() 
mouse.position()[@] 
# move menu to mouse position 
y = mouse.position()[1] 
master. config(menu=menubar ) 
master.geometry( '%dx%d+%d+%d' % (78,0,x-8,y-46) ) 
mainloop() # run drop down menu 


mouse = 
ea 


def clicked(n): # instrument is chosen from menu 
global instNumber 
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instNumber[insToChange] = n 
master.destroy() # remove menu window 


def handleMouse(pos): # look at mouse down 
global insToChange, running 
#print(pos) 
if pos[@] > 184 : # look at triggers 
for row in range(@,9): 
for place in range(@,16): 


if matrixRect[row][place].collidepoint(pos): 


#print("click in pad",row, place) 
matrixCont[row][place] “= 1 # toggle pad 
drawPads() 
pygame.display.update() 
else: 
for i in range(@,9): 
# look at instrument rectangles 
if instRect[i].collidepoint(pos): 
insToChange = i 
pygame. draw. rect(screen, (128,8,8), 
instRect[i],2) 
pygame.display.update() 
return 
if startRect.collidepoint(pos): 
running = True 
if stopRect.collidepoint(pos): 
running = False 


def handleMouseUp(pos): # look at mouse up 
if pos[@] < 184: # instruments and controls 
for i in range(@,9): 
# look at instrument rectangles 
if instRect[i].collidepoint(pos): 
runtk() # launch the instrument menu 
drawScreen() 


def terminate(): # close down the program 
global midiout 
print ("Closing down") 
del midiout 
pygame.quit() # close pygame 
os. exit(1) 


def checkForEvent(): # handle events 
global step,controls, showControls, beat 
event = pygame.event.poll() 
if event.type == pygame.QUIT : 
terminate() 
if event.type == pygame.KEYDOWN : 
if event.key == pygame.K_ESCAPE : 
terminate() 
if event.key == pygame.K_c: # clear pads 
clearPads() 
if event.key == pygame.K_r: # reset sequence 
if not running: 
drawLeds(@) 
pygame.display.update() 
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285. 
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287. 
288. 
289. 
290. 
291. 
292. 
293. 
294. 
295. 
296. 
297. 
298. 
299. 
300. 


301. 
302. 
303. 


304. 
305. 
306. 
307. 
308. 
309. 
310. 
311. 
312. 
313. 


314. 


315. 
316. 
317. 
318. 
319. 
320. 
321. 
322. 
323. 
324. 
3256 
326. 
327. 
328. 


step = -1 
if event.key == pygame.K_i: # inspiration 
randomSetup( ) 


if event.key == pygame.K EQUALS: # increment bpm 
setBPM(10) 

if event.key == pygame.K_MINUS: # decrement bpm 
setBPM(-10) 

if event.key == pygame.K_w: # whole beat 
beat = 4 ; drawLeds(step) 
pygame.display.update() 

if event.key == pygame.K_h: # half beat 
beat = 8 ; drawLeds(step) 
pygame.display.update() 

if event.key == pygame.K_q: # quarter beat 
beat = 16 ; drawLeds(step) 
pygame.display.update() 

if event.key >= pygame.K_1 and event.key <= 

pygame.K_ 9: # set control channel 

controls = int(event.key - pygame.K_@)-1 
showControls = True 3; setBPM(@) 

if event.key == pygame.K_@: 

# cancel control channel 

showControls = False ; setBPM(@) 


if event.type == pygame.MOUSEBUTTONDOWN : 
handleMouse(pygame.mouse.get_pos()) 

if event.type == pygame.MOUSEBUTTONUP : 
handleMouseUp(pygame.mouse.get_pos()) 


def £il11Menu(menu): 
for i in range(len(iNames)): 
menu.add_command(label=iNames[i], 
command=functools. partial (clicked,i) ) 
menu.add_command(label="Exit", command=functools. 
partial(clicked, -1)) 


class AutoBreakMenu(Menu) : 
MAX_ENTRIES = 21 
def add(self, itemType, cnf={}, **kw): 
entryIndex = 1 + (self.index(END) or @) 
if entryIndex % AutoBreakMenu.MAX_ENTRIES == @: 
cnf.update(kw) 
cnf['columnbreak'] = 1 
kw = {} 


return Menu.add(self, itemType, cnf, **kw) 


# Main program logic: 


if _name_ == '_main_': 


main() 
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> Wireless 
internet access 


> Another 
computer 


> Etcher app 
etcher.io 


> HypriotOS image 
magpi.cc/ 
uaOHYS 


This is how 
the user-data file 
should look after 

you uncomment 
WéiFi-related lines. 
Be careful to 

only remove the 
‘#' characters! 
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INSTALL PLEX WITH 


ON 


Learn how to simplify application deployment with 
Docker containers and HypriotOS by installing a Plex server 


O operating system is very useful to its 
users if they can’t run applications on it, 
and so its popularity largely depends on 
a rich application ecosystem. However, there are 
plenty of different operating systems, even for the 
Raspberry Pi, and often the application installation 
process is different on each of them. It becomes a 
serious problem for their users by increasing the 


M@ user-data 


48 | MadgPi April 2018 


entry barrier and for developers who now have 
to prepare their applications for many operating 
systems. Docker containers make things easier, 
providing a unified installation method. Today 
we’ ll learn what containers and Docker are and 
how to use them. 


What is Docker? 


Before Docker became hugely popular, almost every 
operating system had its own means of installing 
applications. This resulted in users, developers, and 
businesses deploying applications to deal with every 
OS independently, requiring additional hours of 
reading tutorials, writing deployment documents and 
automation, and testing and debugging installation 
processes on different OSes. 

In 2013 the dotCloud company released a piece 
of software called Docker, allowing the creation of 
packaged applications that were easy to run using the 
same steps on every system with Docker. If you are 
an OS user, you can try many new operating systems 
and run your favourite applications on them easily, 
without learning the installation intricacies of every 
one of them. If you are a software developer, you can 
stop worrying about all possible OSes and instead 
focus on developing your application and providing 
only one installation process for it, using Docker. 
And if you are a company, you can ease the transition 


raspberrypi.org/magpi 


HypriotOS is a special operating system 
that doesn't provide a typical windowed 
desktop environment 


Our media set for this tutorial fits the 
smallest SD cards, but you might need 
a larger one for your purposes 


of your application from developers’ environments 
onto production servers, saving time and avoiding 
additional issues. 

Docker containers are simply processes running 
on a Linux system that are launched from container 
images. Container images are archives of the 
application files (like HTML and CSS or Node.js 
code), any binaries and libraries required by the 
application (like NGINX web server or a MySQL 
database), and everything else required by the 
application (configuration, network settings, 
and other metadata). 

These container images, also called ‘containers’ 
for short, can be shared between users and 
developers in the form of a single archive file and 
can even be published on an indexing website, 
hub.docker.com, where anyone can browse for 
and download containers to use on their computer 
with Docker. 


Where to start 


First, we need an operating system to run Docker on. 
Docker can be installed in Raspbian, but it is easier to 
use HypriotOS, which is tailored for running Docker 
on Raspberry Pi and comes with everything installed 
and ready to use. 

From magpi.cc/uaOHYS, download the 
latest HypriotOS image (at the time of writing, 
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Plex media server allows easy 
streaming across multiple devices 
from a single media source 


hypriotos-rpi-v1.7.1.img.zip) and burn it to your SD 
card with Etcher. When the SD card is ready, we need 
to edit two files on the boot partition to ensure our 
Raspberry Pi will have internet access. 


It is easler to use HypriotOS, 
which 1s tailored for running 
Docker on Raspberry P1 


In the file config.txt, change the line 
enable_uart=1 (line number 3) to enable_uart=6, 
save and close the file. Next, in the file user-data, 
find a commented block that starts with the line 
#write_ files: and ends with the line path: 
/etc/wpa_supplicant/wpa_supplicant.conf 
(lines 45-63) and uncomment them by removing the 
# character prepending each of these lines, so that 
they look as shown in Figure 1. 

In that block, you need to replace the 
YOUR_WIFI_SSID string with the name of your 
wireless network. You should also replace the 
YOUR_WIFI_PASSWORD string with your wireless 
network’s password. Then, at the bottom of that file, 
finda line # - 'ifup wlan@' and uncomment it as 
well. Save and close the file. 
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Figure 2 Using SSH to log into the Raspberry running HypriotOS over the 
network. You can do that or just use the keyboard for the entire tutorial 


FINDING 
DOCKER 


IMAGES 
FOR Pl 


That’s all there is to it: you can now place the SD 
card into your Raspberry Pi, turn it on, and watch it 
booting HypriotOSs. 


How to use Docker 
Now that we have the system to run Docker on, we 
need to ensure that it’s running properly and has 
internet access. On your screen you’ll see a console 
login prompt, where you should use the default 
HypriotOS user name pirate and the password hypriot 
to log into the console. You will then be greeted with 
the message shown in Figure 2. 

Congratulations, you’re in! Now, to check if 
you have internet connectivity, type sudo ping 
raspberrypi.org -c 1 inthe Terminal; if you have 
a working wireless connection, the output should 
resemble that in Figure 3. 


Congratulations, youre 1n! 
Now, to check 1f you have 
internet connectivity 
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To find out the IP address of your Raspberry Pi, 
enter host black-pearl and you will get an output 
like black-pearl has address 192.168.168.135, 
where the ‘black-pearl’ is the default name of 
HypriotOS system and the ‘192.168.168.135’ is the IP 
address of your Raspberry Pi. Make a note of it, as we 
will use it later. If you want, you may now use the user 
name, password, and IP address to SSH into the Pi and 
continue the rest of this tutorial using an SSH session 
from another computer, but that is entirely optional. 

Now you’ve verified your network connection and 
IP address, the last thing that needs to be done is to 
check if Docker is installed and running. To do so, 
enter systemctl status docker and in the output 
there should be a line that says Active: active 


(running), as shown in Figure 3. It means that Docker 
is installed and running, ready for you to have fun with! 

If your output differs or you are getting any error 
messages, it means your Pi didn’t connect to the 
wireless network properly. In that case, repeat the 
procedure of flashing your SD card and pay attention 
to editing the files exactly as described. 


Do cool things with Docker 

Every coding tutorial on earth starts with a ‘Hello 
world!’ example and we have one like that as 
well. Type docker run hello-world and at 

the top of the output you will see a line reading 
Hello from Docker!. 

What just happened? We’ ve instructed Docker to run a 
program in a container called ‘hello-world’ and, behind 
the scenes, Docker checked that we haven’t got such 
a container image downloaded yet, so it pulled it from 
hub.docker.org and ran a container based on it. The 
application in this container is a very simple one and all 
it does is print the message you can see in your Terminal 
and then exits, terminating the container it ran in. 

Let’s dig deeper into Docker. Type in docker 
pull stealthizer/rpi-whalesay (this may 
take a while depending on your network speed). 
Earlier we started with docker run; it’s a shortcut 
doing a lot of things automatically, but this time 
we have asked Docker to download a container 
called rpi-whalesay from user account stealthizer 
on hub.docker.com and watched Docker pulling 
that image and unpacking it. Now the image is 
available, so we can use it by typing docker run 
stealthizer/rpi-whalesay "I love Raspberry 
Pi!". In the output you will see a picture of a whale 
shouting that it loves Raspberry Pi. 

That command ordered Docker to run an application 
from the container image of stealthizer/rpi-whalesay 
with a text string parameter. Docker noticed the 
image is already available, so it didn’t have to pull 
it and it passed our text string to the container. The 
application inside generated the picture with the text 


Testing internet access, discovering 
Raspberry’s IP address, and checking if Docker is ready 
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Tutorial 


Downloading the Plex image and starting 
a Docker container takes just two commands! 


and exited. Give it a try and have some fun changing 
the quoted text to something else. 


Do something useful with Docker 
Docker simplifies applications and it may seem that 
for things we’ve tried earlier it doesn’t make much of 
a difference. Now we’re going to do something really 
useful that would be very complicated otherwise: set 
up a Plex media server, which lets you stream your 
movies, music, and pictures anywhere on any device. 

First, pull the Plex image with docker pull 
jaymoulin/plex. Then download a multimedia set 
prepared for this tutorial: weet https://magpi.cc/ 
plex-media -O /tmp/plex-media and unpack with 
sudo tar xvzf /tmp/plex-media -C /media. As 
a last step, run the Plex container: docker run -d 
--restart=always --name=plex -v=/media:/ 
media --net=host jaymoulin/plex. 

That command performs a series of events. First, 
it orders Docker to run the application in background 
with a -d flag, then restart it automatically if it 
exists with a --restart=always flag. It then assigns 
the container name with --name=plex instead of 
a random one, connects the /media folder on the 
Raspberry file system to a folder of the same name 
inside the container with -v=/media: /media, sets the 
container network to use Raspberry’s IP address with 
--net=host, and finally specifies the jaymoulin/ 
plex container image to use. Check if the container is 
running fine with the docker ps command and you 
should see output like that in Figure 4. 

Plex is now installed and running, so you 
can configure it. Open http://[YOUR_IP_ 
ADDRESS ):32400/web/index.html in a browser, 
where you replace YOUR_IP_ADDRESS with your 
Raspberry Pi’s IP address discovered earlier (e.¢g., 
http://192.168.168.135:32400/web/index. html). 

The Plex setup screen will open, where it will ask 
you to create an account. Skip this by clicking on 
the ‘What’s this’ link in the bottom-right corner, 
then click ‘Skip and accept limited functionality’ at 
the bottom of the next screen. Click ‘Got it? on the 
next screen and close the ‘Plex pass’ pop-up. On the 
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PLE: 


Server Setup 


Organise your media 


— Films 


a] 


Ca Photos 


following screen with ‘Plex Server Setup’, click Next 
to go to the media libraries configurator. 

Press the ‘Add library’ button (Figure 5) and pick 
the Films library type, then Next, and then ‘Browse 
for media folder’. Click the /media directory and 
select the movies folder inside it, then click Add 
and then ‘Add library’. Repeat this with a Music and 
Photos library, pointing towards music and pictures 
directories respectively. 

After configuring the libraries, click Next and 
Done on the following screen, and the Plex dashboard 
screen will load. Click Settings on the left-hand 
side menu, find the Library menu and tick ‘Update 
my library automatically’ and ‘Update my library 
periodically’ options, then click ‘Save changes’. Now 
you are all set up! Click the home icon in the top-left 
corner to get back to the dashboard. 

You can now watch media files from these 
libraries from a browser on any computer using the 
same wireless network as your Raspberry Pi with 
Docker. There are Plex applications available for tablets 
and smartphones for streaming on mobile devices too! 

There is much more to containers, Docker, and 
Hypriot. To learn more, and even how to build your 
own containers, check out magpi.cc/CmofXu and 
magpi.cc/wvohdL. Happy dockerising! 


Setting 
up Plex with 
media libraries; 
‘Films’, ‘Music’, an 


d 


‘Photos’ are added 


and ready to use 


ACCESSING 
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Tutorial STEP BY STEP 


JEROEN PETERS 


Jeroen spends his day back-end 
developing for Yourhosting and 
loves to create open-source 
projects (mostly) by night. 
magpi.cc/MuQCYY 


KEEP COOL WITH 


> 3.5-inch 
touchscreen 
and case 


magpi.cc/ 
bpWaTO 


> DHT22 sensor 
(on PCB) 
magpi.cc/rVJjfJ 


> USB fan 
magpi.cc/ 
gITcRve 


MAKE 
IT EVEN 
CHEAPER 
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Sitting behind a desk can be very stressful at times, but with some 
clever code and a USB fan, you’ll be able to keep your cool 


othing is as personal as the level of comfort 

someone feels. In shared office spaces it’s 

almost impossible to create a climate in which 
everyone feels comfortable, especially when these 
shared spaces are large. With about 40-50 people ina 
room, we can’t all be happy. We’ve put together some 
components, both hardware and software, to keep us 
cool. Here’s how you can do the same... 


Wire up the sensor 

First things first: this project is all about monitoring 
temperature, so we need to attach the sensor. It’s 
important to do this before attaching the display. Wire 


When the offset is passed, 
the USB port will be powered 
and the fan turns on 


up the temperature sensor using the PiFan wiring 
diagram in Figure 1. 


Attach the other components 

After you’ve attached the sensor, mount the display 
on the Raspberry Pi. It slots nicely on top of the 

GPIO pins, so this should be easy. Now you can build 
the acrylic case around it to support the display and 
protect your Raspberry Pi. Of course, you should 

make sure the sensor stays on the outside of the case. 
After completing the case, plug the USB fan into your 
Raspberry Pi. If your USB fan has a power switch, hit it 
to make sure it works. 


The current temperature is 
measured constantly and 
compared to the offset 
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KEEP COOL WITH A PI-POWERED FAN 


>STEP-03 

Set up the OS and display 

The manufacturer of this screen has an image of 
Raspbian (with Raspberry Pi Desktop) available, which 
has the display driver built in. You can download it to 
burn to an SD card from magpi.cc/aNmzpT. Follow 
our guide to burn SD cards here: magpi.cc/2fZkyJD. 

If you want to install the driver manually, or have 
another type of screen, that’s no problem. Just be sure 
to use Raspbian with the Raspberry Pi Desktop so that 
Chromium is available. 


>STEP-04 

Download the software 

Open the Terminal (or dial in with SSH from another 
computer) to install and download all of the software. 
We’ ll start with the prerequisites. Install them with 
the command: 


sudo apt-get install nginx-light supervisor 
git build-essential python-dev python-pip 


Also install the Python framework Falcon 
by executing: 


sudo pip install falcon==1.0.0 
Now clone and install the sensor module driver: 


git clone https://github.com/adafruit/ 
Adafruit_Python_DHT.git /tmp/dht 

cd /tmp/dht 

sudo python setup.py install 


Now clone the PiFan GitHub repo with the 
following command: 


git clone https://github.com/ 
jeroenpeters1986/piFan.git /home/pi/pifan 


All software needed will now be on the Raspberry Pi. 


>STEP-05 

Configure the software 

We now need to configure the software we just 
downloaded. The following commands will configure 
the web server and create three processes that will be 
supervised (so they are always available): 


sudo rm /etc/nginx/sites-enabled/default 

cd /home/pi/pifan/config 

sudo cp nginx-sites-enabled-default 
/etc/nginx/sites-enabled/default 

sudo cp supervisor-* /etc/supervisor/conf.d/ 


The last requirement is to autostart Chromium with 


the interface. Create the autostart folder and change 
directory to it: 
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e Figure 1 This diagram 


shows you how to 
attach the sensor 


mkdir -p /home/pi/.config/autostart 
cd /home/pi/.config/autostart 


Within this directory, create a file called 
AutoChromium.desktop: 


sudo nano AutoChromium. desktop 
Then type in the following: 


[Desktop Entry] 

Type=Application 

Exec=/usr/bin/chromium-browser --noerrdialogs 
--disable-session-crashed-bubble 
--disable-infobars --disable-translate 
--kiosk http://127.0.0.1 

Hidden=false 

X-GNOME -Autostart-enabled=true 

Name=AutoChromium 


Now save the file and reboot the Raspberry Pi, so you can 
see if it worked. 


>STEP-06 


Customise your PiFan 

If you know a thing or two about HTML and CSS, and 

a little bit about JavaScript, you can customise the 
interface yourself! There is only one HTML file you 

can edit. In there, you’l also see the JavaScript and 

CSS references. To customise the PiFan touch interface, 
edit the /home/pi/pifan/webinterface/index. html 

file. Once you have made changes, tap the refresh 
button on the top-right of your touchscreen to see 
your changes. 


SHUT IT 
DOWN 


Tap the fan- 
guy in the 


top-left and 
the PiFan text 
is highlighted. 
Tap this text 
to engage 

a proper 
shutdown. 
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CORRECTLY 
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> Minecraft Pi 


> An idea fora 
great house 


> A keyboard 


STEVE MARTIN 


Steve has worked in the software 
industry for 25 years and runs a 
Code Club at Longlevens Library 
in Gloucestershire. 
twitter.com/0x90_Bug 


BUILD A HOUSE IN 
USING PYTHON 


Get creative with Minecraft on the Raspberry Pi and learn 
to program in Python by building your own house 


riting programs that create things in Minecraft 

is not only a great way to learn how to code, but 

it also means that you have a program that you 
can run again and again to make as many copies of your 
design as you want. You never need to worry about your 
creation being destroyed by your brother or sister ever 
again when you can simply rerun your program and get 
it back. Whilst it might take a little longer to write the 
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program than to build one house, once finished you can 
build as many houses as you want. 


Co-ordinates in Minecraft 

Let’s start with a review of the co-ordinate system 

that Minecraft uses to know where to place blocks. 

If you are already familiar with this, you can skip to 
the next section. Otherwise, read on. 
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Minecraft House Design 


Width (X Axis) 


Depth (2 Axis) 


Figure 1 This is the plan view of the house. Note that it 
has a door on one side and windows on all four sides 


Minecraft shows us a three-dimensional (3D) view 
of the world. Imagine that the room you are in is in 
the Minecraft world and you want to describe your 
location within that room. You can do so with three 
numbers, as follows: 

How far across the room you are. As you move from 
Side to side, you change this number. We can consider 
this value to be our X co-ordinate. 

How high off the ground you are. If you are upstairs, 
or if you jump, this value increases. We can consider 
this value to be our Y co-ordinate. 

How far into the room you are. As you walk 
forwards or backwards, you change this number. 

We can consider this value to be our Z co-ordinate. 

You might have done graphs in school with X going 
across the page and Y going up the page. Co-ordinates 
in Minecraft are very similar, except that we have 
an extra value, Z, for our third dimension. Don’t 
worry if this still seems a little confusing: once we 
start to build our house, you will see how these three 
dimensions work in Minecraft. 


Designing our house 

It is a good idea to start with a rough design for our 
house. This will help us to work out the values for the 
coordinates when we are adding doors and windows 
to our house. You don’t have to plan every detail of 
your house right away. It is always fun to enhance it 
once you have got the basic design written. Figure 1 
shows the plan view of the house design that we will 
be creating in this tutorial. Note that because this is 
a plan view, it only shows the X and Z co-ordinates; 
we can’t see how high anything is. Hopefully you can 
imagine the house extending up from the page. 
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We will build our house close to where the Minecraft 
player is standing. This a good idea when creating 
something in Minecraft with Python, as it saves us 
from having to walk around the Minecraft world to 
try to find our creation. Right, let’s get coding. 


Starting our program 

Type in the code as you work through this tutorial. 
You can use any editor you like; we would suggest 
either Python 3 (IDLE) or Thonny Python IDE, both 

of which you can find on the Raspberry Pi menu under 
Programming. Start by selecting the File menu and 
creating a new file. Save the file with a name of your 
choice; it must end with ‘.py’ so that the Raspberry Pi 
knows that it is a Python program. 

It is important to enter the code exactly as it 
is shown in the listing (house-complete.py). 

Pay particular attention to both the spelling and 
capitalisation (upper-or lower-case letters) used. 

You may find that when you run your program the 
first time, it doesn’t work. This is very common and 
just means there’s a small error somewhere. The error 
message will give you a clue as to where the error is. 

It is good practice to start all of your Python 
programs with the first line as shown in our listing. 
All other lines that start with a ‘#’ are comments. 
These are ignored by Python, but they are a good way 
to remind us what the program is doing. 

The two lines starting with from tell Python about 
the Minecraft API; this is a library that our program 
will be using to talk to Minecraft. The line startingme = 
creates a connection between our Python program and 
the game. Then we get the player’s location broken 
down into three variables: x, y, and z. 


Building the shell of our house 

To help us build our house, we define three variables 
that specify its width, height, and depth. Defining 
these variables makes it easy for us to change the 

size of our house later; it also makes the code easier 
to understand when we are setting the co-ordinates 
of the Minecraft bricks. For now, we suggest that you 
use the same values that we have; you can go back and 


Tutorial 


Figure 2 This 

initial shell of the 
house is already 
complete. Smash 
through one of the 
walls to make sure 
that the house is 
hollow inside 
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house-complete.py 


#!/usr/bin/env python3 
from mcpi.minecraft import Minecraft 
from mcpi import block 


# Connect to Minecraft 
mc = Minecraft.create() 


# Determine the Player's current position. 
X,y,Z = mc.player.getTilePos() 


width = 5 
height = 3 
depth = 6 


# Create a hollow shell made of bricks. 
mc.setBlocks(x, y, z+3, x+twidth, y+theight, z+3+depth, block.BRICK BLOCK.id) 
mc.setBlocks(x+1, y, z+4, x+width-1, y+theight-1, z+2+depth, block.AIR.id) 


# Set the floor. 
mc.setBlocks(x-1, y-1, z+2, x+1+width, y-1, z+4+depth, block.COBBLESTONE. id) 


# Add a Door. 
mc.setBlock(x+1, y, z+3, block.DOOR _WOOD.id, ®@) 
mc.setBlock(x+1, y+1, z+3, block.DOOR_WOOD.id, 8) 


# Add Windows. 
setBlocks(x+3, y+1, z+3, x+4, y+2, z+3, block.GLASS.id) 
setBlocks(x+2, y+1, z+3+depth, x+3, y+2, z+3+depth, block.GLASS.id) 


mc. 
mc. 
mc. 
mc. 


setBlocks(x, 


The house now has a door and cobblestone 


Pi * 


floor. It is already possible to walk inside 


yt1, z+5, xX, yt+2, z+7, block.GLASS.id) 


qanquage 


>PYTHON 3 


DOWNLOAD: 
magpi.cc/oRCLSD 


setBlocks(x+width, y+1, z+5, x+width, y+2, z+7, block.GLASS.id) 


# Add a Roof. 

for i in range(int(width/2) + 1): 

mc.setBlocks(x+i, ytheight+i, z+3, x+i, ytheight+i, z+3+depth, block.STAIRS WOOD.id, 0) 

mc.setBlocks(x+width-i, y+height+i, z+3, x+width-i, ytheight+i, z+3+depth, block.STAIRS WOOD.id, 1) 

# Gable ends. 

if (int(width/2) - i > @): 
mc.setBlocks(x+1+i, y+height+i, z+3, x+width-i-1, y+height+i, z+3, block.BRICK_BLOCK.id, 0) 
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mc.setBlocks(x+1+i, y+height+i, z+3+depth, x+width-i-1, y+height+i, z+3+depth, block.BRICK_BLOCK.id, 1) 
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change the values once the house is complete and you 
want to alter its design. 

It’s now time to start placing some bricks. We 
create the shell of our house with just two lines of 
code! These lines of code each use setBlocks to create 
a complete block of bricks. This function takes the 
following arguments: 


setBlocks(x1, y1, z1, x2, y2, z2, block-id, data) 


x1, y1, zl are the co-ordinates of one corner of the 
block of bricks that we want to create; x2, y2, z2 are 
the co-ordinates of the other corner. The block-id 
is the type of block that we want to use. Some blocks 
require a further data value; we will see that being 
used later, but it can be ignored for now. 


We have to work out the values that we need to use in 
place of x1, y1, z1, x2, y2, z2 for our walls. Note that what 
we want is a larger outer block made of bricks and then 
to fill it with a slightly smaller block of air blocks. Yes, in 
Minecraft even air is actually just another type of block. 

Once you have typed in the two lines that create 
the shell of your house, you should run your program. 
Before doing so, you must have Minecraft running 
and displaying the contents of your world. Do not 
have a world loaded with things that you have created, 
as they may get destroyed by the house that we are 
building. Go to a clear area in the Minecraft world 
before running the program. When you run your 
program, check for any errors in the ‘console’ window 
and fix them before continuing trying to run it again 
until all the errors have been fixed. 
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You should see a block of bricks created, as shown 
in Figure 2. You may have to turn the player around in 
the Minecraft world before you can see your house. 


Adding the floor and door 

Now, let’s make our house a bit more interesting. 
Add the lines for the floor and door. Note that the 
floor extends beyond the boundary of the wall of the 
house; can you see how we achieve this° Hint: look 
closely at how we calculate the x and z attributes as 
compared to when we created the house shell above. 
Also note that we use a value of y-1 to create the floor 
below our feet. 

Minecraft doors are two blocks high, so we have to 
create them in two parts. This is where we have to use 
the data argument. A value of @is used for the lower 
half of the door, and a value of 8 is used for the upper 
half (the part with the windows in it). These values 
will create an open door. If we add 4 to each of these 
values, a closed door will be created. 

Run your program again to check that the floor and 
door are created (Figure 3). Before you do so, move toa 
new location in Minecraft to build the house away from 
the previous one. You will need to fix any errors. Even 
when your program runs without errors, check that the 
floor and door are positioned correctly. If they aren’t 
then you will need to check the arguments to setBlock 
and setBlocks are exactly as shown in the listing. 


Adding windows 

Hopefully you will agree that your house is beginning 
to take shape. Now let’s add some windows. Looking 
at the plan for our house, we can see that there is a 
window on each side; see if you can follow along. Add 
the four lines of code, one for each window. 

Now you can move to yet another location and run 
the program again; you should have a window on each 
side of the house (Figure 4). Now our house is starting 
to look pretty good! 


Tutorial 


Adding a roof 

The final stage is to add a roof to the house. To do 
this we are going to use wooden stairs. We will do this 
inside a loop so that if you change the width of your 
house then more layers are added to the roof. Enter 
the rest of the code. Be careful with the indentation: 
we recommend using spaces and avoiding the use 
of tabs. After the if statement, you need to indent 
the code even further. We use four spaces for each 
indentation level, so after the line with if on it you 
will need eight spaces for the indent. 

Since some of these code lines are lengthy and 
heavily indented, you may well find that the text 
wraps around as you reach the right-hand side of your 
editor window - don’t worry about this. You will have 
to be careful to get those indents right, however. 

Now run the complete program. Iron out any last 
bugs, then admire your house. Does it look how you 
expect? Can you make it better? 


Customising your house 

Now you can start to customise your house. It is a good 
idea to use ‘Save As’ to save a new version of your 
program so that you can keep different designs, or 
refer back to your previous program if you get to a point 
where you don’t understand why it doesn’t work. 


Consider these changes: 

Change the size of your house. Are you able also to 
move the door and windows so they stay in proportion? 
Change the materials used for the house. An ice 
house placed in an area of snow would look really cool! 
Add a back door to your house. Or make the front door 
a double-width door. 


We hope that you have enjoyed writing this program 
to build a house. Now you can easily add a house to 
your Minecraft world whenever you want to, just by 
running this program. 
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Figure 4 The 
windows have 
been added on 
all four sides 
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CODING GAMES 
ON THE RASPBERRY PI 


IN C/C++ BG 


If coding is about manipulating data, let’s manipulate some data 


Code::Blocks 
sudo apt- 
get install 
codeblocks 


STB 
magpli.cc/ 
2GCQe19 


A pretty picture; 
not too big 


READ 
THE CODE 


There are 
comments and 
descriptions in 
the code that 
explain what 

it is Supposed 
to do. 


| 
| aqme street 
\ Lexx 


he graphics in our game so far are nice, but a 
bit simple and fixed. Also, we only have one 
eraphic. This can be easily fixed by making our 
CPU do what a CPU is designed to do, which makes 
our life a lot easier. We also need to try to make the 
creation and use of graphic objects easier and more 
flexible. Let’s begin. 

We mentioned last time that all programming 
is about manipulating data based on conditions or 
needs. Let’s consider a possible need we have and 
think about how we can manipulate the data. 

At the moment we move our squares based on 
values -1.0f to +1.0f on the x and y axes. This gives 
us a rather cumbersome way of working out their 
position on the screen; we can only really be sure 
of the centre 0,0 position and the edges. This is all 
because of the way our GPU thinks about the buffer 
it draws graphics in, called the clip space. Fora 
GPU, it makes sense to use a value that represents a 
ratio of the size of its clip space buffer; for a human, 
though, we’re much more comfortable with the idea 


ra * 
i fT #e o> Te | 


WES, fib \ 
Leow APTER fF a 


Figure 1 An array holds data or pointers to data 
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of Cartesian x-y co-ordinates, which represent pixels 
in that space. 

Another slight issue is that our ‘squares’ are not 
actually square — they are rectangular. That’s because 
our concept of -1.0f to +1.0f is considered to be a ratio 
of each axis of the clip space, which we set to bea 
rectangular size when we defined our screen sizes. 
Our images also use those ratios, so they become mini 
rectangles like the screen. 

So it’s clear we need to do something to turn these 
ratio values into simple pixel co-ordinates and get rid 
of this rectangular distortion. 

We have to keep in mind that our GPU thinks in 
terms of clip space, so when it draws, it will need 
to use a clip space value. If ‘we’ want to use pixel 
co-ordinates, we have to transform them into ratios 
for the GPU to use. 

So we have a need: we want to use pixel 
co-ordinates and turn them into clip-space ratios 
when the GPU wants to use them. There are actually 
two ways to do this. We can do it in our draw code 
before we send the position value to the shader, using 
quite a simple sequence of steps; or, even cooler, we 
can do it in the shader itself. 

Which is best? Well that’s a really good question, 
because both systems will work. Ideally, we want to 
make it happen on the shader, because shaders love 
doing maths. To begin with, let’s do it on the CPU so 
we can be very sure about what is happening. 


Time for maths! 

There’s no escaping the fact that manipulation of 
almost any data is maths, but it’s usually very simple 
maths; if you know how to do basic arithmetic, you 
can accomplish a lot of things. 
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$9 S846 


ef | va) reas ; 


MagPiHelloTriangle. 
Cpp, 
SimpleObj.h/cpp, 
Game.h/cpp, 
OGL.h/cpp 


DOWNLOAD: 
magpi.cc/PryrsN 


Here, all we want to do is turn a pixel value that is 
easy for us to understand into a ratio that is easy for 
the GPU to understand. This is a case of using the 
pixel values and sizes we have and seeing them as 
fractions, which then become ratios. We have a slight 
complication since the clip screen uses co-ordinates 
between -1.of and +1.of, and we really want to remove 
negatives. However, we know the width and height of 
Our screen, SO in our update we can do this: 


Pos[0@] 
Pos[1] 


((Xpos-512) / 512); 
((Ypos-384) / 384); 


Subtracting half the screen height or width, and 
then dividing the result by that half value enables us 
to move our co-ordinate systems to a bottom-left 
position: 0,0. 

Now we can code that in our draw function, and 
change our initialise and update systems to work on 
real pixel values instead of ratios. So, rather than 
test for -1.0f and +1.0f, test for o and SCREENWIDTH 
for the x direction, and 0 and SCREENHEIGHT 
for the y direction. 

Try to make the changes in Lesson 3’s code, 
use co-ordinates in your update code, and convert 
before the draw sends to the shader (you will also 
find it on the GitHub: magpi.cc/2suLVC2). You can 
see we are bouncing around still, but now we have 
a much easier-to-understand co-ordinate system 
which allows us to think in pixel terms rather than 
ratios. Our needs have been partially resolved; we 
still have our oblong shapes and another niggle: 
they’re the wrong size! 


How to make it better 
To fix the oblong issue, we also need to change the 
ratio-based offsets that make up the triangles, and 
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Figure 2 Nice and square 


here we run into a bit of a quandary. Yes, we can do it 
in our CPU code, but if we’re trying to change data we 
send to the shader, wouldn’t it be better if the shader 
changed the values? 

Well, the answer is probably yes, but it does mean 
we need to make changes to our shader, and pass 
information that allows it to convert screen-based 
co-ordinates to ratios. 

We know we pass information from code to 
the shader in uniforms, as we did with the ratio 
co-ordinates. Let’s try sending info on the screen 
size, by modifying the shader and changing our 


There's no escaping the fact 
that manipulation of almost 
any datais maths 


uniform send systems to pass position and Screen 
Size data. Check out the new shader in the code for 
this lesson: magpi.cc/PryrsN. 

Now when we run these we get nice square objects, 
but there’s one last thing we want: the ability to 
dictate their size. 

As our The MagPi logo was quite large, our current 
triangle vertices are actually 0.1f offsets. This means 
they are already one-tenth their natural size, but we 
might want to have them be any size. This is called 
scaling, and again it’s best done in the shader. We 
now need to pass three things to the shader: the 
co-ordinates (as x and y pixel values), screen sizes, 
and a scale value. 

Now, that is starting to sound like a lot of data 
to send, and it is. We can live with it for now, but 
ideally we should try to organise the data in a better 


USE GOOD 
TOOLS 


We're about 

to make a 2D 
tile game, so 
find a good 

tile editor: 
mapeditor.org 
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Tutorial WALKTHROUGH 


NEVER 
FORGET THE 
IMPORTANCE 
OF GOOD ART! 


If you can't 
draw, make 
friends with 
someone 
who can! 


Figure 3 

Let's look at what's 
in box number 
2DArrayStreet [3] [2] 


Figure 4 
Now we can 
print tiles 
froma grid 
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way. To this end, let’s consider a couple of data 
storage concepts. 


Arrays and structs 

Arrays are useful: they allow us to keep sequences of 
data in order and accessible. There are actually several 
types of array, but we only need to use two types for 
now: single- and two-dimensional (2D) arrays. 

A single-dimensional array is like a street of houses 
(Figure 1), with each house containing some piece of 
info we want, or allowing us to store or get info. The 
house number tells us which house to go to, while the 
name allows us to access the correct street of houses. 


float ArrayStreet[10] ; // defines an 
array with 1@ float entries 


So float value = ArrayStreet[2] tells us to 
go to house number 2 (actually the third house’) on 
ArrayStreet and we can load value with whatever 
we find in that house. 


* Note that array number systems don't start at element 1, 
but element 0. This is Known as base 0 indexing, since coders 
regard the number 0 as having a useful value as an index. 


PP PP PER Pe 


A 2D array can be thought of as rows of streets, with 
an extra identifier to indicate which row we want, as 
well as the house identifier. 


float ArrayStreet2D[Which_Row] [House] ; 


There’s a small downside to an array: it’s only able 
to hold one type of info. So an array of floats means 
each ‘house’ can only contain float values, and an 
array of ints can only contain ints, and so on. We can 
eet round that, though, because it’s possible for us 
to define our own info types, in something called a 
‘struct’, short for structure. 

If you look at the code for this lesson (OGL.h) 
you will see how we define a struct. This is a really 
useful concept and lets us define a new ‘type’ of user 
variables to suit our particular needs. 

Grouping important data in this way keeps it in nice 
handy chunks that can be stored easily and sent to the 
shader quite cleanly. 

Review the Lesson 4 code and comments to see 
how we are storing and using the new simpleVec2 
data type. 

We’ll send pixel co-ordinates to the shader and let it 
do the maths, so in total we have to send two position 
floats, easily held in a simpleVec2, and two screen size 
values, also held in a simpleVec2, and finally a single 
float for scale in x and y. 

Figure 2 shows our use of the new shader with 
The MagPi logo, but Lesson 4 is now set up to use new 
tile graphics. Our objects are now square, we can scale 
their size, and they will stay square unless we decide 
to add separate x and y scale values. 


Creating a playfield 

We are now very close to having a working but still 
inefficient framework. We have a method where we 
can place objects in pixel co-ordinates. That allows us 
to place objects exactly where we want to. But it raises 
a question: what do we want to place? 

For now, we want to use tiles. We can now use 
square objects and set the size, which gives us 
a perfect opportunity to make use of a 2D array 
(Figure 3) to show a grid that has tile numbers, and 
relate them to screen positions. 

Check out the Game class update within the code. 
When it starts, it scans though our grid using two 
loops, and we create and place objects at a relative 
location on screen. 

As well as scanning the grid to make and store 
objects in a pre-prepared array, we find what tile 
eraphics we need, load them, and then supply a 
tile with it (Figure 4). Again, it’s not actually very 
efficient, but we’ll fix that soon. 

Now, we have tiles and a playfield. Next time we 
are going to create sprites and interact with this new 
playfield, and talk about C++’s greatest challenge: 
handling memory. 
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CoderDojo 


Canlstarta 
CoderDojo club 
In my local area? 


CoderDojo is a global network of free, volunteer-led, project-based 
programming clubs for children aged 7-17. Dojos are championed by 
individuals all around the world who are passionate about giving young 

people the opportunity to learn to code. 


incredibly 
rewarding experience 


“| started a Dojo to give my kids a place to meet other children also 
interested in programming and making games. | get to see them 
making new friends, learning from one other, and they loved it. 
Realising how | had created such a wonderful place for children has 
ignited a spark in me.’ 

- Maroes, CoderDojo NL 


The CoderDojo Foundation is Irish Registered Charity (524255) CHY20812 
and is part of the Raspberry Pi Foundation, UK registered charity 1129409 


/ imme YOUR QUESTIONS ANSWERED INFED A a 
PROBLEM 


gare QUE NILY SOLVED? 
ASKED QUESTIONS Vesa 


Your technical hardware and software problems solved... 


assuming you have the correct libraries installed to 
run them of course. All the tutorials and projects 
you’ll find in past issues of The MagPi and on the 
Raspberry Pi website will continue working with 

| 6 A I \ EW P] simon nord 
Similar hardware 


rrerneerereeeey i z HATs will still work on newer Raspberry Pi boards, 
att | Hee AMESIIEEE LULL — : = so you’ ll just need to transfer over any relevant 
"eg ee configuration files to get them running. The new 
PoE HAT, though, is designed specifically for the 
Want versus need new Pi 3B+, so you won’t get it working on a Pi B+ 
If you’re happy with your ora Pi2. 
current Raspberry Pi, there’s no 
immediate need to upgrade. Most Same Raspbian 


tutorials and projects are made The Raspbian operating system is used across all 
to be used with any Pi model, Raspberry Pi models, so there shouldn’t be any 
and the updates to Raspbian will confusion or need to learn new stuff when getting 
continue to be made with every a new Pi. All the same software and such will also 
Raspberry Pi in mind. be available on newer hardware. 


Newer is better 

That being said, newer Raspberry 
Pi models (such as the 3B+ in 
this issue) have performance 
improvements over the previous Put it to work in the house 


versions. The extra power or If you fancy putting together a file server or finally 
connectivity options might help solve an issue you’d creating a Kodi box or retro games console, now is 
had in a project, or even just improve your Raspberry the time to do it since you have a spare Raspberry 
Pi desktop setup. Pi. These projects are easy and quick to make, 


and at least your old Pi will still be put to use. 
For business 


If you use a Raspberry Pi in an enterprise setting, Zero to do 

newer Pi models tend to have extra functions with While the Raspberry Pi 3B+ is more powerful than a 
business in mind, such as the Power over Ethernet Pi Zero, the Zero’s size makes it much more suitable 
(PoE) pins and PoE HAT coming to the Pi 3B+. Like for smaller projects, so don’t count it out yet. Keep 
any new bit of tech, it’s worth researching to see your Pi Zero for projects that could use it over a 

if it would aid your company. bigger and more powerful Pi. 


Give it to someone in need 

There are many organisations that could do with 
more Raspberry Pi boards, whether it’s your local 
Jam or Code Club or even a school in need of 


Backwards compatible computers. They don’t always need the latest and 
Python code and Scratch programs will work just ereatest Pi, as tutorials will work fine across a broad 
fine when moved between Raspberry Pi models, range of different models. 
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FROM THE RASPBERRY PI FAQ 
RASPBERRYPI.ORG/HELP 


WHAT DO I GET WHEN I BUY ONE? 

You get the Raspberry Pi board itself. A power supply and microSD 
card are not included, but can be purchased at the same time 
from most places that sell the Raspberry Pi. You can also purchase 
preloaded microSD cards; we recommend buying these from us or 
our licensed distributors rather than from third parties on eBay, as 
our software is updated regularly and cards sold by third parties 
can quickly become outdated. 


WHY IS THE PRICE IN US DOLLARS? YOU ARE A UK COMPANY! 

The components we buy are priced in dollars, and we negotiate 
manufacturing in dollars. Because currency markets are so volatile, 
we price the final board in dollars as well so we don't have to keep 
changing the price. 


CAN I BUY A RASPBERRY PI KIT? 

Raspberry Pi resellers produce some great bundles for people who 
would rather get everything they need from one source. In 2016, 
we put together our own Raspberry Pi Official Starter Kit. The kit 


is available to order online in the UK from our partners element14 
(magpi.cc/qWBdNT) and RS Components (magpi.cc/wRQHGW), 
for £99 + VAT, and from distributors and resellers around the world. 


IS THERE A BUY-ONE-GIVE-ONE PROGRAMME? 

Not at the current time. We may implement a programme of this 
sort onE day, but the scale of an undertaking like this is something 
our small team isn't equipped to handle. You can, of course, simply 
buy an extra Raspberry Pi to donate to the person or organisation of 
your choice. 


| WANT TO BE A RASPBERRY PI RESELLER. 

We have an exclusive manufacturing and distribution arrangement 
with RS and Farnell. Resellers buy the Raspberry Pi in bulk from 
them (which reduces shipping costs to nearly nothing) and sell on. 
You do not need any special licence to resell, and the distributors 
are very happy to sell on to resellers. If you are interested in joining 
our Approved Reseller programme, contact us by sending an email 
to info@raspberrypi.org. 


INTRODUCING THE HOTTEST 


PRODUCTS FOR YOUR PI 


; 


~ 
a % CO > 
pak 7 U 


www.shop.sb-components.co.uk Call: 0203 514 0914 Mac 


a: 
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The obstacle course 
for the first Pi Wars 
was much simpler 


MagPi April 2018 


he Raspberry Pi has helped revolutionise 
many things. From computing education, 
to the maker community, and even how 
you play games at home, the Raspberry Pi has 

had a huge impact. It’s also helped change the 

face of hobby robotics, making it more accessible 
than ever before. 

To celebrate this renaissance of robotics, the 
organisers of the regular CamJam event hold a yearly 
contest known as Pi Wars that pits the Raspberry Pi 
community’s best automated efforts against each 
other. There’s no fighting, though: the robots take 
part in devious challenges designed to test how well 
they’ve been built and programmed, and at the end 
of the day they get to be taken home in one piece! 
Most of the time. 

This year, over 70 teams are taking part over two 
days. Here’s what you can expect from the event. 
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THINGS HAVE CHANGED OVER THE YEARS. HERE’S WHAT HAPPENED AT THE LAST THREE PI WARS 


i Wars is a spin-off from the 

CamJam — the Cambridge 

Raspberry Jam. Now in 
its fourth year, the competition 
has grown in size and scope, as 
challenges and team categories 
are added or updated so that the 
contestants can get a truly fair test 
of their skills against their peers. 

Michael Horne, CamJam and Pi 

Wars organiser, tells us a little bit 
about the history of the event... 


PI WARS 2014 


This competition, in December 
2014, was our first, and was held at 
CamJam’s previous regular home 
at the Institute of Astronomy. 
The courses were a little low-tech 
— unpainted hardboard, courses 
on table tops, and a line-follower 
course made out of paper taped 
together. It took place over just 
one day and we split robots based 
on cost — sub-£75 and over-£75 
(not including the Raspberry 

Pi). Challenges were as follows: 
Obstacle Course, Line Follower, 
Proximity Alert (get as close as 
possible to a wall), Robot Golf 
(push a ball through a hole ina 
wall), Straight Line Speed Test, 
Sumo Battle, and the fiendish 


The obstacle course received 
a big update for 2015, including 
the now famous turntable! 
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Three Point Turn which was an 
autonomous test of a robot’s 
ability to drive forward, make a 


turn in the road, and then return to 


its starting position. 


PI WARS 2015 


The 2015 competition was also 
held in December and we moved 


venue, to the Cambridge Computer 


Laboratory (William Gates 
Building), to give us some more 
Space to work with. The courses 
were much better presented — 
featuring actual paint! - and we 
changed some of them to keep 
things fresh. The challenges were: 
Obstacle Course (with different 
obstacles and featuring the brand 
new turntable, designed and 
created by PiBorg), Skittles (knock 
the pins over with a ball), Pi Noon 
(robot vs robot balloon popping), 
Straight Line Speed Test, Three 
Point Turn, Line Follower, and 
Proximity Alert. This time, robots 
were split between those under 
A4 size and those between A4 and 
A3 size. This increased size gave 
us some challenges as the courses 
needed to allow for larger robots. 


Atense Pi Noon match at 
last year’s Pi Wars event 


PI WARS 2017 


For 2017, we decided to move the 
event to April to allow schools, in 
particular, more time to work on 
their robots and to avoid exams. 
We also decided to hold the event 
over two days, with schools taking 
centre stage on the first day and 
everyone else being divided into 
three categories on the Sunday: 
Beginners, Intermediates, and 
Advanced. We were welcomed back 
to the Cambridge Computer Lab and 
this was the busiest event yet with 
around 60 robot teams competing. 
The challenges were once again 
revised: Straight Line Speed Test 
(which was changed to a strictly 
autonomous event), the Minimal 
Maze (a new autonomous course), 
Line Following (which used the 
outline of our robot logo - much 
to the dismay of many teams!), Pi 
Noon (which added another two 
balloons as targets to be popped), 
Obstacle Course (which doubled in 
size from previous years), Skittles 
(this time, teams had to go and 
‘collect’ the ball to be rolled at the 
pins — a slight misstep on our part as 
it proved to be a very tricky physical 
challenge!), and Slightly Deranged 
Golf (in which a real golf ball had to 
be moved around a short course and 
through a windmill’s rotating sails 
at the end and into a hole). 
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Registration for the 


next Pi Wars isn't 
open yet but when 
it is, you'll find it on 
piwars.org around 
autumn time. Make 
sure you apply early 
- registrations close 
before the event 
and you can't just 
turn up on the day 
with a robot in hand! 
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WANT TO ENTER PI WARS? YOU'LL NEED A ROBOT THEN... 


WHERE TO BUY 


ROBOT PARTS START! 


STARTER KITS 


If you want to learn how to 
make robots, you need to start 
at the beginning. Here are some 
ereat starter kits that you can 
go on to expand into your own 
robo-competitor. 


magpi.cc/HdclIvp 

As wellas selling kits from PiBorg, 
one of the leading Raspberry Pi 
robotics makers, ModMyPi has other 
kits and plenty of robot components. 


> 
magpi.cc/MokmEg 
An expensive kit 
but a very good 
one — PiBorg’s 
DiddyBorg isa 
powerful Raspberry Pi 
robot running on six wheels to 


, 
>» 


> 
magpi.cc/dYpiRj 

The GoPiGo 3 kit is a great starter for 
people wanting to learn how to code 
and control robotics. With the base 
kit and a great set of tutorials, you’ ll 
quickly figure out the basics. The 
controller board lets you connect 
extra sensors, allowing you to learn 
and grow your robotics skills. 


magpi.cc/skzElb 

America’s premier hobby electronics 
supplier also has an amazing range 
of robot parts and kits that it has 


developed itself. 


adatrui 


dexterindustries.com 

Dexter is a hobby robotics specialist, 
with a number of kits and sensors 
and such made specifically for 

the Raspberry Pi. You can buy its 
products from ModMyPi in the UK. 


[1 DEXTE 
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make it extra sturdy. You’ll be 
able to outrun all your opponents 
with it, and you can easily add 
sensors to make sure it can be 
fully autonomous. 


> 
magpi.cc/TADbiy 
From the robot 
boffins at PiBorg, 
the new version 
of the YetiBorg is built to 
run on a Raspberry Pi Zero. It’s 
small, powerful, and extremely 
well put together, much like 

the other PiBorg offerings. The 
ZeroBorg motor controller it 
comes with lets you add standard 
analogue sensors, and can be 
daisy-chained too. 


magpi.cc/t(NKkmk 

A great, classic starter kit, the 
CamjJam Edukit 3 comes with the 
basics for making a robot. You’ll 
need to add a Raspberry Pi and 
chassis — although you can always 
use the box for the latter! It’s a very 
simple robot, but it does teach the 
basics and has decent parts that you 
can use when building your robot. 
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TYPES OF 
SENSORS 


magpi.cc/UJaTWJ 

Ultrasonic sensors use ultrasonic 
sound waves to measure distance. 
They’re pretty popular among 
robot kits because not only do 
they help teach you about sensor 
programming, they also look 

like eyes. 


magpi.cc/28ljIsz 

With a bit of skill, and a lot of help 
from the OpenCV software library, 
you can get a Raspberry Pi robot 

to react to the world around it. It’s 
mainly used for differentiating 
colours, but OpenCV is very 
powerful and can do more. 


Comera V2.1 


Made in PRC 


raspberrypi.org/magpi 


magpi.cc/ujFFZz 

These sensors are great at following 
a line drawn on the floor, by sensing 
the difference in shade between 

the two. Line-follower sensors are 
usually hidden under a robot and 
used for fun circuit challenges. 


magpi.cc/rVRhwP 

Depending on material, an infrared 
range finder can be more accurate 
than an ultrasonic one. However, 
they don’t work so well outdoors. 
Luckily, Pi Wars is an indoor event! 


magpi.cc/vywZnT 

Some simple robot kits make use of 
microswitches to figure out when 
they’ve hit a wall. Classically, the 
robot will then turn away from the 
wall, but you can always add one 

as a Shut-off switch for a straight- 
line speed test 


WANT A HAND BUILDING A ROBOT? 


MAYBE THESE PLACES CAN HELP 


i 
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magpi.cc/RmMbMDY 

The PiBorg forum is a great place to ask about 
PiBorg kits. The team behind them are experts at 
robotics as well, so they should be able to help you 
with any query. 


raspberrypi.org/forums 

The Raspberry Pi community are always happy 

to help someone in need. Give the forum a search 
first to see if any of your questions have already 


Ww I ed. 


We've done robot tutorials 
in the past - including a 
guide on how to make and 
upgrade one in issues 51 
and 52 respectively. 


aoe 
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HERE ARE SOME OF THE TOP ROBOT TEAMS FROM PAST PI WARS - WHAT HELPED THEM WIN? 


REVENGE 
OF PYROBOT 


PI WARS 2015 
LARGER THAN A4 
BRIAN CORTEIL 


Brian Corteil should be 
recognisable to readers of the mag 
— he wrote our feature on building 
a robot in The MagPi #51, which 
was then further developed into 
the Tiny 4WD. He entered the first 
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One of the unique features of 
TractorBot was the interchangeable 
noses for different contests — for 
example, for the golf game they 
used an extended nose that would 
keep the ball rolling ahead of the 
robot. Unfortunately, while good for 
keeping the ball under control, it did 
not help to release the ball through 
the hole. They were also able to add 
pipe insulation for the sumo contest 
to soften impacts on the robot. 


TRACTORBOT 


PI WARS 2014 
UNDER £75 
IPSWICH MAKERSPACE 


One of the first winners of Pi Wars, 
the TractorBot was made out of 
laser-cut wood and created by the 
folks at Ipswich Makerspace, who 


are veterans of the competition. 
a” 


Pi Wars with the robot PyroBot, 
which unfortunately did not place. 
However, he came back stronger in 
2015 with the Revenge of PyroBot. 

“My robot Revenge wheel 
layout was inspired by PiBorg 
DiddyBorg kit layout,” said Brian. 
“T built the chassis in a weekend 
and was driving it on the Sunday 
evening. The rest of the robot 
was added over the following 
months, with the final design put 
together on the Friday evening 
before Pi Noon!” 


Build your base 
early. Drive it at 

least a couple of 
"1 hours, two days 

a week. 


——— 


KENH 
EVOLUTION 


PI WARS 2015 
A4 AND SMALLER 
ANDY & HARRY MERCKEL 


Evolution was built specifically for 
the A4 category, with the aim to 
make a bigger and better robot than 
the original. The ability to swap 
attachments was dropped because 
of the time involved (although one 
was created for Pi Noon). It was,a— 


much sturdier beast, using more 
KEITH Evolution is the second custom parts than before as well. 
robot by the Merckel team, the “We tried to build a robot that 
aptly named evolution of their would be able to do well in all of 
robot KEITH from the first Pi Wars. the challenges,” the team wrote. Sy, 


KEITH stands for Kinetic Electronic 
Interactive Tracked Hardware. 


“Although there were many 
compromises along the way!” 
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EX AB OT — along with a lot of training to get 
to grips with some of the challenges 


awaiting at Pi Wars.” ( 
P| WARS 2017 While of course the robot build is 
SCHOOLS AND KIDS CLUBS very important, training and testing 
TEAM EXABOT Should not be overlooked. The ExaBot 


team even went as far as building 
“Our team built a completely custom their own maze to tweak their 
robot for this year’s competition,” the software at the last minute, finding 
team wrote on their blog. “Working some issues they were able to account 
on everything from the core electrical for before the big day. Still, issues 
and mechanical design tothe Python — were found during the challenges, so 


program used to operate the robot you can’t account for everything. 

Pale BIT with he and Rebelle learning as 
they went. Simpler solutions were 
found in favour of going over the 

PI WARS 2017 top, including one involving the 
BEGINNERS use of multiple distance sensors 
BROUGHTON FAMILY for the maze, and a simple claw/ 

mandible design controlled by 

Tom Broughton and his daughter motors for manipulating the ball 

Rebelle had never built arobot before, _in the golf challenge. 

but that wasn’t going to stop them “Very naively we assumed it 

from entering Pi Wars — after all, it would be a very simple task to put 

did now have a Beginners category. a robot together,” Tom admitted. 

You can follow the very careful “But we soon realised, as mentioned 

progress of building the robot on in many of our posts, what a huge 

Tom’s blog (digitalpolymath.co.uk), underestimation this was.” 


months before the April 2017 
Pi Wars event, going through 
different controllers as the robot 


STEVE 


P| WARS 2017 was built and tested. In the end, 
INTERMEDIATE Steve ended up being a modest 
TEAM STEVE robot, running off a Raspberry Pi 
Zero and an Arduino, and using a 
Steve is not a fancy acronym (or Dagu chassis and speed controller. 
backronym?) like KEITH, but is Despite this, it managed to win the 
instead just a robot called Steve. Intermediate category and even 
A robot that looks like a dog. came first in the golf challenge. 
Steve had been in the works for Good boy, Steve! 
exception, especially compared to PI WARS 2014 
MAX the balancing two-wheel robot he > Under £75 
had originally planned for the 2017 > Over £75 
P| WARS 2017 competition (hence the team name). 
ADVANCED/PRO Compared to the Tiny and the PI WARS 2015 
2 WHEELS OR Tiny 4WD, Max has an additional > Larger than A4 
NOT 2 WHEELS series of distance and line sensors > A4 and smaller 
and a more custom chassis. While 
Brian Corteil came back to Pi Wars it didn’t do particularly well in the PI WARS 2017 
last year with another winner in automated events, Brian’s tactic > Schools and Kids 
Max, based on the Tiny robot that of practising his robot control paid > Clubs 
was originally built for The MagPi! off, with him placing highly in (and > Beginners 
Brian is great at building powerful, even winning two of) the manual- > Intermediates 
sturdy robots and Max is no control events. > Advanced/Pro 
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THE EVENTS AT PI WARS TEST THE BUILD QUALITY AND PROGRAMMING SKILL BEHIND EACH ROBOT. 
CO-ORGANISER MICHAEL HORNE REVEALS THE TASKS THEY NEED TO CONQUER 


AUTONOMOUS CHALLENGES 


A shallow trough 7.3m (24 feet) 
long comprises the course for the 
speed test. Your robot needs to 
traverse this course autonomously 
as fast as possible, without hitting 
the sides. The course is usually 
534mm wide, but there are 
sections where it will narrow. 
With a white line down the centre 
which you can use for navigation, 
the course will be run three times 
and the scores for each run added 


together. While it seems like it will 
be simple, any robot maker knows 
that very few robots go in a straight 
line without some coding help. 


OFFICIAL TIP: It's important 
to get a balance between being 
as fast as possible and being 

as accurate as possible - we've 
added chicanes which count 

as ‘walls’ which incur penalties 
when touched. 


CPCS LEE ETE TEE SEEDTELOEEEEHELOEHETEOEOOH EE OHEEHEOTEOEEE TE OEOE HE SOOEHEESOOEEETTTOTEHEHEEOEEETEOEEHETTOTEEEHETOOEEDESECEEEESELEREELELOOEEEEELEEEED OOOO OEE 


Robots are placed at the centre of a 
Square arena in this new challenge. 
The wooden arena measures 122cm 


by 122cm, and the black walls 
are 300mm high. At each corner 
there’s a coloured ball suspended 
100mm off the floor of the box. 
Your robot must visit each ball 
once, and they can do that in any 
order, or shoot for more points and 
go in the predetermined order of 
Red, Blue, Yellow, and Green. 

The kicker? Each ball’s 
placement will be random for each 
team, so the robot truly has to look 
for the correct colour. Contestants 
have seven minutes to perform 
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Don’t let this simple-looking maze fool you: this 
can be quite tricky for robots as you’re not allowed 
to help them, and they’re not permitted to touch 
any walls. 

The concept behind this maze is for your robot to 
sense the different colours that are painted on the 
wall to inform how it navigates. Programming your 
robot to turn while seeing certain colours, and only 
moving so much at atime, is Key to navigating the 
maze successfully. While slow and steady can win 
the race, the event is 
measured on completion 
time, so don’t dawdle. 


SC COT CCC ESTOS OSOS SESS SSS SSOSOT OSES ESOSOSSSOTES OSS OSS 


OFFICIAL TIP: 
There are so many 

ways to do this, but 

we've allowed the 
addition of ‘markers’ on 
the course which might | 
be an easy way to 
orientate yourself if you : 
use ‘vision to navigate. | 


a maximum of three attempts, 
with their fastest attempt used 
for scoring. 


OFFICIAL TIP: We're supplying | 
a calibration or ‘try out’ course in 
addition to the ‘real’ course - use 
it to get your sensors in shape 

before the real runs. 
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REMOTE-CONTROLLED 


Pee ererrerecerceserereceesererereesereseeereeeeoesoeeeeeroeseneEeeeeoeE® 


Think mini golf in this excellent 
challenge that showcases your 
robot’s dexterity and your team’s 
ability to precisely control it. A real 
golf ball must be pushed around a 
eolf course, avoiding obstacles, and 
dropped into the hole at the end. 
You can’t carry the ball, and the 
ball is only allowed to leave the 
surface of the course if the team/ 
robot decides to chip the ball. 
Otherwise, pushing and hitting the 
ball is the way to go. Teams can’t be 
cheeky and ‘capture’ the ball with 
the robot either. The total time after 
three runs will be used in scoring. 


OFFICIAL TIP: \We've lowered 


the tee this year, so it should 


be easier, but get control of the 
ball early! 


An audience-favourite challenge 
that somewhat resembles the 
battle mode from Mario Kart. Each 
robot is equipped with a series of 
tiny balloons, along with a needle. 
The aim is to pop your opponent’s 
balloons with your needle, and not 
have your own popped. 

Each duel lasts three minutes. 
There are many rules, such as 
‘don’t spin’ and ‘don’t purposefully 
damage the opponent’, which are 
mainly in place to reinforce that 
this is supposed to be a fun event 
that you shouldn’t try and game 
by being silly. Remember, judges’ 
decisions are final. 


OFFICIAL TIP: Practise remote- 


controlling your robot as much 


as possible, as control is vital in 
this challenge. 
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The obstacle course is a lot of fun... 
to watch. Robots regularly get a bit 
stuck and teams usually get a bit 
frustrated, which makes for great 
drama. It should be televised really. 
While the exact layout of the 
obstacle course is a mystery until 
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the day, in the past there have been 


ramps, marbles, sharks, and The Big™ 


Whirling Circle™ to contend with. 
Contestants need to figure out the 
best way to tackle each obstacle, and 
hopefully prepare their robot for 
any eventuality. You only get one 
attempt, and you’ll be judged on 
how fast you complete the course / 
Although don’t just try to charge 
through obstacles. 


OFFICIAL TIP: Without giving too 


much away, make sure you can get 


out of tight spots, maintain control, 
and practise slow turns. Grippy 
wheels will help this year, too. 


Robots will be placed in front of the 
targets, and will not be allowed to 
cross a boundary line that is at least a 
metre away from the targets. Several 
targets will be presented between 10 
and 15cm in height, held at different 
elevations, and not all at the same 
distance from the boundary. 

Robots can either use five supplied 
balls to knock down the targets, or 
use a pre-installed cannon that fires 
up to five soft projectiles (such as 
Nerf darts). Any method of aiming 
is allowed (including laser pointer). 
Contestants have five minutes to 
make three attempts, and points 
will be tallied up depending on how 
many targets are hit. 


OFFICIAL TIP: You only have five 


shots, so be as accurate as possible 
and take your time to line up. 


While completing 
challenges is the 
main way to gain 
points, robots will 
also be judged on 
other aspects... 


BLOGGING 
Keeping a log of 
how you built the 
robot, with added 
photos and video, 
can help you win 
extra points. 


TECHNICAL 
MERIT 


Your robot goes 
before the trained 
eyes of engineers 
to ascertain the 
quality of your Pi- 
powered machine. 


ARTISTIC 
MERIT 


Does your robot 
look cooler than 
a T. Rex surfing 
while wearing 
sunglasses? Then 
it will win some 
extra points. 
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£12.99 


200 pages of 


RASPBERRY PI 


PROJECTS BOOK 


Ce MOLUMES 


Amazing hacking and making projects 
from the makers of MagPi magazine 
Inside: 
® How to get started coding on Raspberry Pi 
® The most inspirational community projects 
® Essential tutorials, guides, and ideas 


@® Expert reviews and buying advice 


Of le ® 
Ce magpi.cc/store 


plus all good newsagents and: 


WHSmith BARNES&NOBLE 


9 Available on the GETITC 


App Store »» Google Play 
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MALRIA 


MATRIX VOICE 


From £40 / $55 


VOICE 


A voice-recognition board featuring an LED loop and 
eight-mic array. Phil King has a few words with it 


AlY 
VOICE KIT 


Google's 
cardboard 
kit for voice 
recognition 
includes a 
mini speaker 
and two-mic 
array, while 
its Voice HAT 
board features 
connections 
for servos 
and motors. 


magpi.cc/AWeXwv 
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easuring 3.14 inches 
(8cm) in diameter, this 
circular add-on should, in 
mathematical terms at least, prove 
a perfect fit for the Raspberry Pi. A 
GPIO header extender enables it to 
clear the Pi 3’s USB ports, but will 
also work with any newer 40-pin 
model, including the Pi Zero. It 
looks good mounted on top, a blue 
LED on its underside illuminating 
the Raspberry Pi board below. 

In essence, the Matrix Voice 
is a Slimmed-down spin-off of 
Matrix’s original Creator board. 
Whereas the Creator was crammed 
with all sorts of sensors, and 


a Xilinx XCOSLX9 Spartan 6 FPGA 
(field- programmable gate array), 
whose 9152 logic cells offer scope 
for customisation if you know how. 


ESP or not 

Two versions of the Voice are 
available: standard and ESP32 with 
built-in WiFi and Bluetooth. While 
the former relies on connection toa 
Raspberry Pi, the latter (costing an 
extra $10) can be programmed ona 
Pi before being set free to function 
as a Standalone device. The most 
visually impressive aspect of the 
Voice is its circular ‘Everloop’ array 
of 18 RGBW LEDs. As well as the 


Compatible with a wide range of 


voice assistants, 


including Alexa 


and Google Assistant 


other bells and whistles, the Voice 
focuses On voice recognition. To 
this end, it retains the array of 
eight digital MEMS MP34DBo2 
microphones, although here 
they're arranged differently: seven 
placed at regular intervals around 
the perimeter and an eighth in 
the middle. Audio processing — 
including noise cancellation and 
de-reverberation — is handled by 


ability to display cool light patterns, 
this can provide useful visual 
feedback during voice interactions. 
Near the middle of the board, as 
on the Creator, is a square hole for 
mounting a Camera Module if you 
wish. Elsewhere, a 24-pin female 
expansion header is connected to 
the FPGA to connect and control 
electronic components, but (testing 
it with a basic LED circuit) we were 


unable to use it to 
access the Raspberry 
Pi’s GPIO pins directly. 


Many voices 
One of the key plus points of the 
Voice is its compatibility with 
a wide range of voice assistant 
platforms, including Amazon 
Alexa, Google Assistant, and 
PocketSphinx. Disappointingly, 
however, getting started with the 
device is made more difficult by 
the lack of helpful, Voice-specific 
information on the matrix.one 
website. A lot of the documentation 
and examples are related to the 
Matrix Creator, and the Voice data 
sheet only offered links to a couple 
of tutorials. Matrix tells us it is 
working on creating additional ones 
and improving the documentation. 
Following the Alexa step-by-step 
cuide (magpi.cc/Wzovwo) took 
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over two hours, including lengthy 
Matrix software installation and 
setting up a developer account with 
Amazon. We had problems getting 
it to capture our voice at first, but 
upon reinstalling to a fresh Raspbian 
Stretch image it worked well. The 
mic array was able to pick up our 
“Alexa” wake-word even from the 
far side of the room, the LED loop 
glowing green as Alexa then listened 
to our enquiries and commands. For 
sound output to a speaker, for some 
reason we were advised to use the 
Raspberry Pi’s 3.5mm jack rather 
than the one on the Voice. 
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Exploring Matrix’s GitHub repo, 
we discovered a PocketSphinx 
example (magpi.cc/qIRbbH) to 
show LED patterns triggered 
by speaking various phrases. 
Examining the demo code (written, 
like the other examples, in C++) 
gave us an insight into how to listen 
for keywords and trigger the LEDs. 

Of the few other code examples 
compatible with the Voice, we 
found one for sensing the direction 
of sounds using the eight mics. 
While possibly useful for a project, 
the demo code (for the Creator) 
would need altering to suit the 
Voice’s different mic array layout. 


The top of the 
Voice features a 
ring of 18 RGBW 

LEDs and eight 
mini microphones 


A 
complete, 
affordable, 
and user- 
friendly tool 
for simple 
to complex 
loT voice app 


creation 
Matrix 


noo ten non 


Ke) eet es ee De ee es ee ~_ _ 


r L 


ee | ~~ se ee eee 


of be ha = 
ee ee es 
i. ‘citn om jf 
— bs if ; ji 
cal 


.o 


D1000 00008 


TTTTTTiT TTT 


While the Matrix Voice is clearly 
a capable piece of hardware, until 
the documentation improves it’ ll 
be hard to make the most of it. 


The Matrix Voice hardware is polished, capable, 
and versatile, but the lack of specific product 
support on the Creator-focused website currently 
makes it difficult for users to get started. While the 
Voice's spec is superior, its price is also higher than 


some simpler rivals, such as the Seeed ReSpeaker 
4-Mic Array (£23) and Joy-IT Talking Pi (£31), which 
may well be sufficient for many home projects. 


KK 
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MAKE MARK 
APP BE IA 


Rob Zwetsloot investigates a different way of linking 
Dropbox to Raspberry Pi using middleware 


ropbox has never been very 
well supported in Linux. 
Raspbian has it even worse 


than standard flavours of Linux. In 
the past, getting Dropbox to sync 
to a Raspberry Pi has required some 
custom coding, but Make Mark App 
makes the process a bit easier. 


creating folders on the Raspberry 
Pi, setting up folders on Dropbox, 
and making it launch at boot. You 
can then log in to Make Mark from 
the website and manage your files. 
Still in beta, the software 

currently only supports PDFs and 
e-book files. The system truly acts 


Works well as a middle step for 


transferring files between the 
Raspberry Pl and Dropbox 


It’s still a little DIY: you need to 
set up Make Mark as an app in the 
developer section of your Dropbox 
account and get an app token. With 
that, you can download a script 
that will set up everything you need 
to install the app. This includes 


as middleware — it will list what files 
you can upload from your Raspberry 
Pi and then has you manually do so. 
They’ ll then show up in Dropbox in 
the Make Mark App folder. 

We had a little trouble with 
setup, but the developer is working 


on making it better. Instructions 
and documentation are provided 
in somewhat broken English, 
although they’re easy enough to 
understand to get you started. 

While it’s not the full auto- 
syncing solution we’d been hoping 
for, it does work well as a middle 
step for transferring files between 
the Raspberry Pi and Dropbox. We 
look forward to seeing it become 
easier to install and support more 
files in the future. 


fast word 


It's definitely a beta, but shows 
great promise for a future 


middleware app for Raspberry 
Pi and Dropbox. 
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HackSpace 


TECHNOLOGY IN YOUR HANDS 


4 NEW MAGAZINE 
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Raspberry Pi finds a new home 


Versatile enclosure for Raspberry Pi B+ 

The new UCS-RPI Universal Case System for Raspberry Pi B+ has pre-milled side 
walls for easy access to the I/O and power inputs. It is available in black or grey, in 
two size configurations and with glue dot location posts to secure the single board 


computer to the case. 


For additional information call 0845 881 222? or visit 


phoenixcontact.co.uk/RPIBC 
DGD OO GD GD OGD OO OD [ionic ODE 
LMCONTACT 


INSPIRING INNOVATIONS 


OFFICIAL 
RASPBERRY 
P| CASE 
Amore versatile 
case. While it 
does look cool, 

it may not quite 
be NES cool. 


£6 /$10 
magpi.cc/ppUaBN 
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NES CASE 


Maker 
says 
NES case 
specifically 
designed for 
Raspberry Pi 
3, 2, and B+ 


Kintaro 


NES CASE 


Rob Zwetsloot plays with power as he turns his Raspberry Pi 
into a mini NES with the Kintaro Entertainment System 


ases for the Raspberry Pi 
are a dime a dozen these 
days, so it’s nice to see 
people selling fun themed cases 
for your Pi projects. It sets them 
apart from the myriad plastic, 
yet functional, cases for the 
Raspberry Pi. 

The maker of this case, Kintaro, 
sells a couple of retro-console- 
themed cases. Along with this 
NES-inspired case, you can also 
geet a(US purple) SNES-style 
case. The NES one is smaller and 
simpler than the SNES version, 
but still functions as a proper 
Raspberry Pi case. 

Putting a Raspberry Piin the 
case couldn’t be easier — the two 
halves come unfastened in the 
box so you can separate the two. 
Inside you’ ll find four screws and a 
couple of heat sinks in bags which 
you’ ll need to remove. Place the 
Raspberry Pi inside the bottom 
half, replace the top half, and then 
use the provided screws to secure 


the halves together from below. 
Job’s a good ’un. 


Flip the flap 

While on the original NES the 
controller ports were located on 
the front of the machine, the USB 
ports on the Raspberry Pi aren’t 
quite arranged like that. Ina rather 


system. However, even with the 
‘vents’ on the side of the case, 
accessing the GPIO pins is tricky, 
and putting a camera cable through 
the USB flap isn’t ideal. While the 
case was not designed with this in 
mind, it’s worth mentioning in the 
event that you were planning to 
use this as your only case. 


Useful for using a Raspberry P1 
as a Standard computer 
or aretro gaming system 


ingenious move by Kintaro, the 
cartridge flap has been recreated 
on this case — simply flip it up to 
gain access to all the USB ports and 
the Ethernet port. Otherwise, all 
the important ports and slots are 
accessible while the Raspberry Pi is 
in the case, even the microSD slot. 
The case is really useful for 
using a Raspberry Pi as a standard 
computer or a retro gaming 


fast word 


A great, simple case that might 
be good for your home media 
setup if you're missing the 


elusive NES Classic Mini. Don't 
get it for hacky electronics 
projects, though. 
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RASPBERRY PI 
BESTSELLERS 


No Starch’s Manga guides use manga 
storytelling to make difficult subjects 
surprisingly approachable 


THE MANGA GUIDE 
TO LINEAR ALGEBRA 


Authors: Shin Takahashi 
& Iroha Inoue 

Publisher: No Starch 

Price: £19.99 

ISBN: 978-1593274139 

magpi.cc/ NGUfyX 


We all reach a stumbling point 
somewhere when learning maths. 

If linear algebra is yours, Takahashi's 
narrative-driven breakdown of 

the subject into small chunks and 
essential diversions will make 
several difficult concepts suddenly 
easy to understand. 


THE MANGA GUIDE 
TO CALCULUS 


Authors: Hiroyuki Kojima 
& Shin Togami 

Publisher: No Starch 

Price: £15.99 

ISBN: 978-1593271947 

magpi.cc/ moKUBC 


A lovely attempt at tying calculus 
into its real-world applications, 
from an economist with a strong 
appreciation of the subject. 
Perhaps best used in tandem 
with a dryer and deeper textbook 
or MOOC, but it will make either 
much clearer. 


THE MANGA GUIDE TO 
REGRESSION ANALYSIS 


Authors: Shin Takahashi 
& lroha Inoue 

Publisher: No Starch 

Price: £19.99 

ISBN: 978-1593277284 

magpi.cc/KobuGE 


A well-chosen subject fora 
manga guide. If the level is 

not always perfectly judged, 
the overall result is still a fair 
understanding, with illustrated 
analogies often helping to 
clarify difficult concepts. Again, 
a good companion to more 
traditional learning. 
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CRACKING CODES working up to more advanced 
WITH PYTHO Python topics. Python’s strengths 


at data handling make this 
CRACKING c oves sort of thing fairly painless, 
icosces miaecastes eh and (relatively) few external 
libraries are needed, so the 
beginner can Stay fairly focused 
on learning coding, not stacking 
together modules. 

Complete code listings are 
given early in each cipher sample, 
erowing longer with each chapter 
— these are well commented, 
and slowly broken down and 
examined, so the beginner need 
not feel too intimidated. Learning 
from working through longer 
listings is reminiscent of the 
1980s, when magazines for the 
classic 8-bit computers carried 
long programs to type in. But 
never mind the nostalgia, it’s a 
ereat way to learn — especially 
for adults and teens who aren’t 
eripped by game coding. 


Author: Al Sweigart 
Publisher: No Starch 
Price: £25.50 

ISBN: 978-1593278229 7 
magpi.cc/ WiQljD : 


Yes! A book that 
teaches Python 
programming without 
games, but is still full of fun, 
intrigue, and playfulness. Along 
the way you’ll also learn a lot about 
ciphers, encryption, and hacking 
— although little of the book deals 
with modern ciphers that are 
secure against the computational 
power that can be wielded against 
them, by working through 
centuries old ciphers you’ 1] learn 
many of the principles behind 
today’s encryption. 

You’ll also learn a lot of 
programming techniques, and 
the practical nuts and bolts of 
programming, from handling text, 
through loops, to functions, then 


CLEAN C++ 


Author: Stephan Roth 
Publisher: Apress 
Price: £29.99 

ISBN: 978-1484227923 
magpi.cc/LlIKCOy 


Score 


not just a restatement of best 
practices laid down in many 

Java books, but as it goes from 

the general to the specific, the 

many C++ examples illustrate 
how relatively simple (and 
ultimately beneficial) it is 
to incorporate the practices 
into your own code. Roth is an 
opinionated commentator — but 
generally in a good way — and 
a knowledgable and passionate 
proponent of best practices. 

“Lots of C++ code that is written 
today looks like it was written in 
the 1980s,” says the blurb on the 
back of the book. All too true, sadly 
— but follow most of Roth’s advice 
and you’ ll find that clean coding 
is not incompatible with C++. 
Everyone who has to work on your 
codebase — including the future 
you — will be grateful. 


C++ projects seem 
more prone than 
most to delivering 
“fast and highly optimised 
[code], with a cruel syntax and 
ignoring elementary principles 
for good design and well- 
written code.” Roth brings all 
the best ideas of the Clean Code 
movement (clean code is easily 
understood and maintained, it’s 
not about ‘beautiful code’), and 
the possibilities of this decade’s 
improvements to the language. 
Clean C++ delivers sound advice 
on testing; design principles 
(and software craftsmanship); 
clean code; object orientation; 
and design patterns. This is 


Score 
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PRACTICAL PYTHON 


DESIGN PATTERNS 


Author: Wessel Badenhorst 
Publisher: Apress 

Price: £27.99 

ISBN: 978-1484226797 
magpi.cc/dVkzoo 


Badenhorst’s mission 

is Simply to make you 

a better programmer. To 
promote thinking at a higher level 
of abstraction, this book teaches 
Design Patterns — something that 
has become popular in particular 
in object-oriented languages 

from Java to Ruby. Beyond that, 
the author is keen for readers to 
emulate the practices of the best 
at the programming art, from 
deliberate practice and single 
focus, through systems thinking, 
to mastering tools, and looking at 
other frameworks, languages, and 
paradigms to see what there is to 
be learned. 


PRODUCT 
ROADMAPS 
RELAUNCHED 


ORER 


Authors: C. Todd Lombardo, 
Bruce McCarthy, Evan Ryan, 
& Michael Connors 


ISBN: 978-1491971727 
magpi.cc/AKZhOp ar 


What is a product roadmap? An 
out-of-date listing of deliverables? 
A best-fit compromise that 
doesn’t really satisfy any of your 
stakeholders? A source of contention 
within your organisation? A bright 
shiny vision of the future that your 
customers don’t trust? Roadmaps 
have failed to keep up with agile 
development, and are often mired in 
detail best put in a project plan. 
Product Roadmaps Relaunched takes 
a fresh look, removing focus from 
deliverables, and looking at the why. 
Where’s the product going — not in 
set-in-stone phases of promised 
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PRODUCT 


Publisher: O'Reilly a 
Price: £27.99 ROADMAP Ss 


RELAUNCHED 


Chapter one alone, containing 
advice on the above, would rapidly 
pay for the book’s purchase by 

the improvements it will 

foster if the reader follows 

through with it — but the 

rest of the book deals 
concretely with design 
patterns, and Pythonic 
implementations of many 
of the most useful. 

The chapters introduce 
a topic, and usually jump 
Straight to a useful code snippet 
— such as implementing part of a 
real-time strategy game for the 
prototype pattern chapter — before 
outlining the problem to be solved 
by the pattern, then taking the 
reader down whichever path best 
advances understanding. As do 
the ‘parting shots’, and a series 
of exercises, at the end of each 
chapter. A good and useful read. 


Score 


deliverables, but in terms of your 
organisation’s values, and where 
you want to make life better for 
your customers? 
If this all sounds a little vague, 
good. Aroadmap isa 
Strategic document, 
ewe §=0t a product plan. 
To make it more 
concrete, the book 
moves from the why 
to the how - to make 
a flexible roadmap 
that can be shared 
with your customers, without 
promising anything that would 
skew the product away from where 
it should be going. This product 
we talk of could be an [oT project, 
app, or website — but the advice 
carries over into many other 
fields. A thoughtful and thought- 
provoking re-examination of one 
of the fundamentals of building a 
successful IT company. 


Score 


ESSENTIAL READING: 


SCRATCH 


The fun and easy way to start kids coding, 
a visual language more powerful than it seems. 


Scratch Website 


Author: MIT 
Publisher: MIT 

Price: Free download 
magpi.cc/sjNTTS 


Naturally, the Scratch website has 
plenty of resources to start your kids 
learning, from free PDF guides to 
Scratch Cards. 


Super Scratch 
Programming Adventure! 
Author: The LEAD Project 
Publisher: No Starch 

Price: £19.99 

ISBN: 978-1593275310 
magpi.cc/kmwfvi 


For confident younger learners, this 
concise, comic-style introduction 
provides a quick introduction, and lets 
your kids make some great games. 


Scratch for Kids for Dummies 


Author: Derek Breen 
Publisher: Wiley 
Price: £21.99 

ISBN: 978-1119014874 
magpi.cc/TCyZow 


Not in any way dumbed down - a 
brilliant guide to sprites, animations, 
comics, programming, and plenty of 
games. And really good fun. 


Learn to Program with Scratch 


Author: Majed Marji 
Publisher: No Starch 
Price: £27.99 

ISBN: 978-1593275433 
magpi.cc/KjPpaU 


Truly excellent introduction to more 
formal programming concepts, 
using Scratch, for beginners or 
experienced Scratchers. 


Cool Scratch Projects 
in easy steps 

Author: Sean McManus 
Publisher: In Easy Steps 
Price: £10.99 

ISBN: 978-1840787146 
magpi.cc/2me3yQu 


Magic Mirror, 3D effects, using the 
Raspberry Pi's Camera Module - there's 
plenty here for any Scratch learner to 
move onto as the next step. 
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: MagPiSummer 


only at BuildPiper.com 


‘It’s a really fun educational computer kit 
that should really impress those who love 


Minecraft and building stuff” Mii ® 
| ag?i 


Want to learn how to bring Piper to your school? 


buildpiper.com/EDU 


THE PIPER EXPERIENCE 


ih 
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SOFTWARE-BASED CURRICULUM CREATE YOUR ELECTRONICS 


< 


Supported by Top University Funds 
Stanford-StartX Fund 
AEF of Princeton University 


Available at: 
BuildPiper.com amazon ys$iu BARNES <cNOBLE 


MAKING MUSIC WITH A 


The album RPi ZWEI was created using just a Raspberry Pi 2 


In general you can find all kinds 
of electronic music, although every 
song is different: from electro/ 
techno-pop, through Eurodance, 
to instrumental electronica [a bit 
like] Mike Oldfield. It then ends ina 
chiptune style with BitPusher2600’s 
remix made on the Pi. 


Why a Raspberry Pi? 

I bought one when the Pi 2 was 
still the new model. However, my 
decision back then was motivated 
directly by the announcement that 
the Raspberry Pi outsold the ZX 
Spectrum. I thought, “Aha! I have 
to get one NOW!” The Raspberry 
Pi, being a British computer, is 
important to me as I’ve been a 

ZX Spectrum fan and user since 
the eighties. 

The Pi is a modern, and potent, 
machine. Obviously, it’s not old 
school, but you can feel some cool 
old-school philosophy behind it. 


aking music on a Raspberry 

Pi is simple enough thanks 

to Sonic Pi. However, 
demoscene musician Yerzmyey 
decided to go one step further and 
make an entire album using the 
Raspberry Pias his instrument. You 
can listen to RPi ZWEI here while 
you read through our interview with 
him: magpi.cc/WhekCf. 


Tell us about your album! What 
kind of music would you say it is? 
Typical demoscene music is 
usually divided in two basic types: 
chiptunes and modules. Generally 
we might say that chiptune music is 
usually synthetic and full modules 
— like MOD, S3M, XM, etc. - are 
Ssample-based. 

The songs on my Raspberry 
Pi album are modules — the XM 
modules to be exact -— made 
with a Raspberry Pi 2 and 
MilkyTracker working on the 
regular Raspbian system. 
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The entire idea of the project was 
to use only Pi 2 and nothing else. | 
composed this music on the Pi and 
then recorded it all directly from the 
headphone output of the board. 

The Pi 2 is powerful so the 
songs can be complicated and use 
multichannel, which makes for a 
ereat tune for the listener. The most 
complex song on the album consists 
of 26 independent channels of digi- 
music. The Pi can surely manage 
more, but that wasn’t the point of 
this album. 


How did you go about composing 
the album? 

I programmed all notes one-by- 
one, as is customary on the music 
trackers. You have to put all the 
notes/sounds in manually without 
any automatic help. Otherwise | 
use loops, but only when it comes 
to drum ‘n’ bass music (drum loops 
are indispensable there) or when | 


Yerzmyey has played music all over the world —- including Japan 
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ALL THE Music WAS, BEEN MADE ON RASPBERRY P| 2. 
ALSO, IT HAS = RECORDED DIRECTLY FROM THE MACHINE. 
| 


ORIGINAL ATARI 2600 ws “DIGITAL GARBAGE” BY ‘BITpusn ER2600. 


(©) 2018 by YERZ 


play the guitar (or ask some friends 
to do it for me; I’m not a very good 
euitarist). I cut these recorded 
euitars into loops and put them 
into the song/module in a form of 
WAV files. Of course, the multilayer 
technique is useful there too, so 

I can ‘play simultaneously’ on 
many guitars. 

My weapon of choice on the 
Raspberry Pi is MilkyTracker, a 
familiar and powerful tool. Of course 
the Pi can do a lot, so for example 
one can use emulators or cross- 
platform trackers to make chiptune 
music too. I tested how the SID chip 
emulation works on the Pi 2, with 
the GoatTracker, and it is really 
nice: magpi.cc/IrjKal. 

There’s other software of course; 
for instance, there is Unreal Speccy 
Emulator for ZX/AY lovers and so 
on. There’s also really complex 
software-synthesizers that you can 
use — you can find out more info 
about them here: magpi.cc/YUXfeE. 


Do you have a background in 
chiptune music? 

For chiptune stuff I mostly use a ZX 
Spectrum 48K with AY-interface, 
although when I started in the late 
eighties, there was only BEEPER 
accessible, so initially I was making 
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2 Made on 
a Pi 2, the RPi 
ZWEI! mini album 
features five tracks 


1-bit music on ‘Wham! The Music 
Box’ and after that I changed to 
SoundTracker 1.1 and the AY chip. 

Since then I’ve made music 
for over 60 games, mostly for ZX 
Spectrum; sometimes with such 
distinguished ZX game-developers 
like Jonathan Cauldwell —- and many 
other, equally talented friends. 

I participated in making numerous 
demos for Spectrum and Atari ST - 
and played many chiptune concerts 
in various places on planet Earth. 


How long have you been 

making music? 

I remember making songs for our 
eroup’s first demos and games 

in 1987 — games like Ghost Eater 
(1987) andHunting (1988) — but I 
don’t think they exist any more 
(everything was recorded on tapes 
in those days) so the earliest demo 
I still have containing my chiptune 
attempts comes from 1989 and my 
first game music (a text adventure) 
comes from 1993. 


Have you used the Raspberry Pi for 
anything else? 

Like I mentioned before, the Pi is 

a powerful machine so I use it for 
literally everything. It’s as useful as 
any other modern computer (not to 


“YeERZMYE 


mention it’s much cheaper, smaller, 
cuter, and far more portable). 

Text editing, spreadsheets, 
internet with YouTube included, 
music listening, watching movies, 
and stuff like that. I also do a lot of 
gaming, mostly using RetroPie. 

Mave my PC amd rine Pi 
permanently connected into one 
switchable monitor so I don’t have 
to buy a second PC, as the Pi is 
totally enough. Ten years ago this 
was unthinkable. They weren’t 
called towers for nothing. 


Do you plan on making more music 
with Raspberry Pi? 

Actually I do. Of course, every time I 
try to make some new stuff, so this 
time I was considering buying and 
using the Raspberry Pi Zero fora 
change. A smaller machine, more 
limited — it might be interesting. | 
will try, presumably. 

Another thing would be to make 
something for the Pi 3, but it’s so 
powerful that probably I would have 
to make — I don’t know - some 
symphonic music on it? Which 
might be tricky because last time 
I tried that was in the ‘gos. Also, 
trackers aren’t very good for this 
particular kind of music (MIDI is 
better here). But we will see. Or hear. 
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THE MONTHIN 


Everything else that happened this month in the world of Raspberry Pi 


elebrations for the Raspberry Pi’s birthday have 

been getting bigger every year, and this year 

was the biggest yet! Over 100 Jams around the 
world organised a special event to honour the Raspberry 
Pi on its sixth birthday, and even despite the snow in the 
UK, the world was abuzz with Pi love. 


Edinburg, TX, USA 


This South Texas Jam couldn't escape 
the fun of the photo booth either 
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oy 
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Irvine, CA, USA 
This Irvine Jam looked huge, with people showing 
off their amazing Raspberry Pi creations 
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Cotswold Jam 
This impressive beast was edible, and 60cm long! 
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Raleigh, NC, USA 
We saw many cakes coming from Pi parties; this amazing 
cupcake delicacy hailed straight from North Carolina 


Lagos, Nigeria 
While fun, some serious learning 
went down at the party Jams 


Tokyo, Japan ae 
The photo booth project ee 1) ‘A Southend, UK 
made for Pi parties was a wf M ; This one was a bit closer to home as young 


huge hit around the world! ork makers got to grips with the Sense HAT 


Unfortunately, a few Jams had to be postponed due 
to the ridiculous snow the UK experienced in March. 
Many Jams will be rescheduling though, so keep an 
eye on your email and social media feeds! 


India 
Hacking about with Raspberry Pis 
under a very fetching blue light in India 
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Community = FEATURE 


The community reacts 
to the latest version of 
a the Raspberry Pi 


new Raspberry Pi is always cause for a mini- 

celebration, even if we’ve just celebrated a : B Rev 4 links 

birthday! Launched on Pi Day (14 March or, in pe et 
American notation, 3/14) the Raspberry Pi 3B+ is the 


Want to learn 
more about 


ultimate version of Raspberry Pi 3. Here are some of the Pi 3B+? 
the reactions from the community to the news... 
B Rev 2 (china) B Rev 2.1 B Check out our 
Oe acs ee eer? a a. — i, * launch video: 
i Fellow fers bert) Re magpi.cc/GqePcN 


Happy Pi Day, people! New @Raspberry_Pi ‘ke va 
3B+ is out. 


Com pute ‘ = Tiemianie sae ‘ Ty tse 
* = a 
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Compute , 
Module 3 at r Raspberry Fl 


Alex Eames of RasPi.TV always updates 
his ‘Pi family’ image whenever a new 
model is released. It now includes 
Brazilian and Japanese Pi boards, too! 


Self-expression can take many forms, 
including excellent Raspberry Pi nail art. 
The glittery green nail polish is also impressive 


FOR YOUR VIEWING PLEASURE 


Here are some great videos about the new Raspberry Pi! 


| magpi.cc/ XzjWXI magpi.cc /msQxvm 


y naspberry Pi 3 gf» 
“4 Model B+ 


NEW RASPBERRY Fl3Bs 
REVIEW AND SPEED TESTS 


RASPBERRY PI 3 MODEL B+ 


INTRODUCING THE RASPBERRY PI 3 MODEL B+ 


Here's a gorgeous little stop-motion 
animation to herald the arrival of 

the wee wonder, directed by Tom 
Sutherland and friends, as a teaser for 
the release. 


Estefannie takes us through the 
differences between the original Raspberry 
Pi 3 and the 3B+, including networking and 
processing speed. It's also a mad video. 


Eben Upton talks to Roger Thornton, Principal Hardware Engineer, 
about what's new with the Pi 3B: in this very informative video. 
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KICKSTART THIS! 


Raspberry Pi projects you can crowdfund this month 
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RASPBERRY BOOM 


Remember the Raspberry Shake? Well, the team 
behind the seismograph HAT for the Pi are now 
crowdfunding a new citizen science add-on with the 
Raspberry Boom. The Boom detects low-frequency 
sounds that the human ear cannot hear, anda 
network of these can help detect and pinpoint a huge 
number of terrestrial and extra-terrestrial phenomena 
that would otherwise go unnoticed. 


HACKABLE RASPBERRY 
Pl SWITCH HAT 


Nanomesher is back to crowdfunding with a new 
Switch HAT, improving on the design of the original 
that we liked so much. It fixes one of our biggest 
concerns with it, the use of jumper cables to connect 
everything. There’s also additional remote support so 
you can use it with Kodi — this is probably going to bea 
bit of a game-changer! 
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COMMUNITY PROFILE 


Meet Amanda, US-based teacher, Raspberry Pi 
Certified Educator, and maker of things 


manda Haughs works as 
- the Digital Innovation 

teacher on special 
assignment (ToSA) for Campbell 
Union School District in San Jose, 
California. Within the role, she 
works to support teachers in 
engaging their students, exploring 
how to create “meaningful 


Lesson Resources, and fun projects 
at home, she’s on the right track to 
be making a big difference, both in 
her district and across the USA. 
Amanda took part in the second 
Picademy cohort to run in North 
America. Picademy, the two- 
day training course run by the 
Raspberry Pi Foundation, provides 


ow Amanda works 

as teacher on special 
assignment within her 
school district to support 
educators in broadening 
computer-science 

skills through cross- 
curricular experiences 


and relevant cross-curricular 
learning experiences.” 

On her website, Amanda 
describes herself as “passionate 
about the integration of technology 
and computer science education in 
elementary classrooms to support 
the development of creativity, 
critical thinking, and problem- 
solving skills in students.” And 
with her continued efforts to create 
content such as her STEAM and CS 


free professional development 
for educators, both in the UK 

and North America. A week after 
the event, as Amanda recounted 
her experience on her blog, she 
was quick to admit that her head 
was “still spinning with all the 
Raspberry Pi goodness” she was 
able to obtain over the weekend, 
and she has since gone on to help 
in further sessions of the training 
across the country. 


Amanda joined 

Raspberry Pi Foundation 
staff members Carrie 

Anne Philbin and James 
Robinson, alongside fellow 
Picademy alumnus Nicholas 
Provenzano, on the Digital 
Making with Raspberry Pi 
panel at ISTE 2017 
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In her role as Digital Innovation ToSA, 
Amanda works with schools and 
educators within San Jose's Campbell 
Union School District, supporting 
cross-curricular learning 


More recently, Amanda has way to incorporate the use of my 
continued to integrate the use of erandmother’s hi-tech embroidery 
Raspberry Pi into the classroom, machine,” she explains in her 
working alongside fellow blog post for the project. “Right 
ToSA Misty Kluesner to create away | thought it would be fun to 
multimedia art projects based on embroider the Raspberry Pi logo 
the theme of Awe and Wonder, and from there I realised that a 
and the Aurora Borealis. This tote bag would be the way to go 
exploration took the coding practice for my first wearable project.” 


of computing classes into the arts 
sector of the school, putting the A 
in STEAM where we are beginning 
to see more and more examples of 
code in art and design. 


The result was a tote bag 
made from scratch that included 
the Raspberry Pi logo and 
programmable LED lights. With 
the conductive thread making up 


Right away I thought it 
would be fun to embroider 
the Raspberry P1 logo 


Outside of her work in 
education, Amanda is a tinkerer. 
While planning her attendance 
to multiple education-based 
conferences and events in 2017, 


she decided to stand apart from the 


crowd by integrating a Raspberry 
Pi-powered wearable into her 
wardrobe. While many wearables 
hide their circuits behind folds 


the outline for the logo, the LEDs 


were connected to a Raspberry Pi 


Zero, and code controlled how and 


when they blinked as she walked 


iiom DOOEMtO DOOtMNal IIS 2017, 
among other events. 

In 2015, she was awarded the 
PBS Digital Innovator Award, 
and followed this up in 2016 with 
the SVCUA Outstanding Teacher 


of fabric, Amanda decided to Award. With her Raspberry Pi 
celebrate hers by using conductive Certified Educator pin to boot, 
thread and her grandmother’s Amanda continues to work hard, 


programmable sewing machine. gaining more recognition along 
“T loved the idea of making the way, and the North American 
something wearable and blinky, Raspberry Pi community is proud 
and also wanted to figure out a to have her on board. 


raspberrypi.org/magpi April2018 MdgPi | 91 


KEIM.ZELLE 


EVENT C ALEND AR RASPBERRYPI JAM V4 


Find out what community-organised, Raspberry 
Pi-themed events are happening near you... 


Want a Raspberry Jam in 
your area? Want to start one? 
Email Ben Nuttall about it: 
ben@raspberrypi.org 


3) RASPBERRY JAM 
LOOP 
Me GUILE EB AEINIES 


P| JAM! RASPBERRY JAM PRESTON RASPBERRY JAM 

When: Thursday 5 April LOOP When: Monday 2 April 

Where: Fab Lab Limerick, When: Saturday 14 April Where: Media Factory Building, 
Limerick, Ireland Where: Bangalore, India PISTON, WLC 

magpi.cc/puDVrT magpi.cc/f[NBYEa magpi.cc/CbQdLN 

A belated Big Birthday Jam will Are you that person who loves PRJ is acommunity of people 

be taking place in Limerick, with all ‘tech stuff? ° Then get over who meet in Preston each month 

show-and-tell presentations, to Raspberry Jam LOOP to learn to learn, create, and share the 

demos, and workshops. about it! potential of Raspberry Pi. 

KEIM.ZELLE RASPBERRYP! JAM P!| WARS 2018 CORNWALL TECH JAM 

When: Saturday 7 April When: Saturday 21 April When: Saturday 14 April 

Where: Lichtenberger Strasse 3, Where: Cambridge Computer Lab, Where: Cornwall College, 
Oberosterreich, Austria Cambridge, UK Camborne, UK 

magpi.cc/jejESY piwars.org cornwalltechjam.uk 

Programming sessions for The big moment is here: Raspberry Learn about coding on a variety 

children and parents, explained Pi robots duke it out in non- of platforms, including Arduino 

step-by-step so that you can destructive challenges to find out and Raspberry Pi, in various 

work at it together. which is the best automaton. programming languages. 
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WE'VE HIGHLIGHTED SOME OF 
THE AREAS IN NEED OF A JAM! 
CAN YOU HELP OUT? 
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PRESTON 
RASPBERRY JAM 


6 CORNWALL TECH JAM 


joan apie RASPBERRY JAM ADVICE 


When: Sunday 29 April WH AT TO DO 


Where: Gartner UK HQ, 
Staines-upon-Thames, UK 
“When | ran the Manchester Jam, people were arty, & / 


magpi.cc/stfIbP 
Primarily a show-and-tell event 


where people bring along their 


f h d happy to work on their own projects. Occasionally e o 
re we ran a track of talks, or put on a workshop, which Y 
learn from. A 


was a nice change. Now | run the Jam at Pi Towers, 
the attendees tended to be mostly beginners - e* 
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LEEDS RASPBERRY JAM 


h usually parents with their children - so we mostly bd RASPB ER RY 
ee eee ey eae run workshops and hand out worksheets.” | I Vi 
Where: Swallow Hill Community Ben Nuttall - | | 


Collesewtecds, Wik 
magpi.cc/Hdaalj 
There will be chances to get hands- 
on with digital making activities 
through the workshop, anda 
hackspace area to share projects. 


Raspberry Jam @ Pi Towers 


Every Raspberry Jam is entitled to apply for qd Jam 
Starter kit, which includes magazine issues, printed 
worksheets, stickers, flyers, and more. Get the — 
guidebook here: magpi.cc/2q9DHfQ 


LETTERS 


CATALOGUING 
OLD ISSUES 


I’m a little bit of a latecomer in the area of trying 
to read all the old issues of The MagPi. It’s a tedious 
task and I have not found a place with a list of all 
the contents. I tried to copy-paste them from each 
magazine but have not quite succeeded. For some 
reason, some of the magazine contents can be 
copied in a reasonable manner whereas some cannot 
— usually requiring some editing. 

Is there a catalogue and if not could you please 
make one? 


Jukka Salo 


Thanks for having a go — unfortunately 
it’s a bit of a big task! We think the best 
way to get a good highlight of projects 
and tutorials and reviews is to check 
out the Official Projects Books that we 
release every year. The best of the best 
make it into these books, which have a = 
comprehensive contents section as well! 
If anyone has started to create a 
catalogue of all our contents, though, 
please let us know! We’d be happy 
to host it on our GitHub repo and 
maintain it diligently. 


Get an excellent 
selection of 
projects and 
articles the easy 
way with our 
Official Projects 
Books! 
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I love the idea, and have long 
wanted to do a RetroPie but... 
years back I ran Sinclair QLs, 
and managed to get the game 
Stellaris, a strategy game, keyed 
in (laboriously, QL SuperBASIC). 
This was at a time when storage 
was by tape, basically a cassette 
recording of the tones of the 
phone-line modems of the day 
(perhaps 9600 bits per second 

— a generous estimate, and yes, 
bits!), and before that degraded 
too far I got it over to a 720kB 
floppy disk. 

The keyboards failed and I 
abandoned them. Meanwhile I 
had already progressed through 
IBMs: PC (180kB 5-inch floppy), 
extender board, XT (360kB 
floppy), extended to 640kB, 
286sx (a rarity — basically an XT 
with a 286 processor), 286, 386 
(720kB floppy, but couldn’t read 
the QL disks :( ), a brief fling 
with Acorn Electron, 486 (1.44MB 
floppy!), Pentium, discovered 


Linux (Slackware!) and onward... 
meanwhile the QLs (and monitors 
and floppies) sat in storage. 

Now running a Core 13 with 
Kubuntu and a Pi 3, with a Pi 
sitting unused, I thought ‘why 
not a RetroPie:’ I dug out the QL 
magazine (QL World, June 1987) 
and OCRed the Stellaris program 
(much easier than typing it all!), 
ending up with a 36kB text file 
that includes the author’s player 
instructions... and then tried 
to find a QL emulator. RetroPie 
doesn’t have one. 

I think there’s one in 
Windows’ ‘DOS box’ system, 
but IIRC (it was long ago) I gave 
up trying to get it to run. Long 
and short: is there a QL emulator 
for the Pi (or other Linux), 
or is there someone adept at 
translation that could/would 
translate the QL SuperBASIC into 
something that could run on 
the Pi: As I read it, it’s rife with 
text boxes spread around the 
screen, and of course the screen 
geometry is all sorts of strange. 
Dexter N Muir 


Unfortunately we don’t have a 
direct answer for you, Dexter, and 
some of the emulators we tried 
to Google don’t all seem to be 
maintained very well. Hopefully 
one of our intrepid readers will 
get in touch and we can sort out 
some kind of solution and get 
back to you! 

Digital preservation is an 
important field at the moment, 
especially with games and 
computer systems slowly dying 
without much fanfare. Maybe this 
could be a step towards saving 
more old tech? 
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FROM THE FORUM: 


The Raspberry Pi Forum is a hotbed of 
conversations and problem-solving 
for the community — join in via 
raspberrypi.org/forums 


s the discount still available for 

The MagPi subscribers for HackSpace 

magazine? I didn’t subscribe early 
as I wanted to make sure the content was 
consistently good and not just for the first 
couple of issues. 


i MAK 
LouisP E acks HACK CREATE 
If you’r € a year "har HANDS Se a er 


long subscriber to 
The MagP1, your 


discount code ca 
DREMEL 


for HackSpace | 

. FASHION 
magazine ee OD ee 
shouldn’t expire. Aim 


We had some 
problems with 
the original SONS CHEERLGHTS PENCLS NEURAL NETWoRKS 
discount code 

being leaked, though, so if you’re having trouble 
sorting out your discount, please drop us a line 
and we can try to sort it out. 
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The simple way to mount your Pi! 


——— 


- Industrial DIN rail mount 
« Open frame for better airflow 
« |ntegrated USB strain relief 
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ee) code 
club 


j 
START A CODE CLUB 
IN YOUR SCHOOL! 


Code Club is a network of volunteers and educators who 
run free coding clubs for young people aged 9-13. 


Our aim is to inspire the next generation to 
get excited about computer science and digital making. 


“We use Code Club's fun educational resources to runa 
weekly after-school club for Year 7 and Year 8 pupils. The 
students benefit considerably from the extra challenge!” 


Karen Dadd, Computing Teacher 


[A Code Club is free 
M4 Code Club provides step-by-step guides for 
Scratch, Python, HTML, and Sonic Pi 


4 Code Club helps children develop skills including 
logical thinking, creativity, and resilience 


We have over 6000 clubs across the UK teaching 
more than 80,000 young people to code—come and join us! 


Find out more at www.codeclub.org.uk 


Code Club is part of the Raspberry Pi Foundation. Registered Charity Number 1129409 65 


WIN'10 


MEARM PI KITS 


We reviewed the MeArm Pi in issue #62 
and found it “a joy to build and use”. You 
can control the MeArm Pi using the twin 
joysticks, or with code. 


“The MeArm Pi ts 
gn easy-to-build robot 
arm kit that's designed 
to get children (and 
qdults!) learning 
about technology, 
engineering, and 


programming." 
Mime Industries 


how shop.mime.co.uk 


Terms & Conditions 


Competition opens on 28 March 2018 and closes on 19 April 2018. Prize is offered to participants worldwide aged 13 or over, except employees of the Raspberry 

Pi Foundation, the prize supplier, their families or friends. Winners will be notified by email no more than 30 days after the competition closes. By entering the 
competition, the winner consents to any publicity generated from the competition, in print and online. Participants agree to receive occasional newsletters from The 
MagPi magazine. We don't like spam: participants’ details will remain strictly confidential and won't be shared with third parties. Prizes are non-negotiable and no 


cash alternative will be offered. This promotion is in no way sponsored, endorsed or administered by, or associated with, Instagram or Facebook. 
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THE FINAL WORD 


ust a few weeks ago we celebrated the sixth 
birthday of Raspberry Pi. To mark the occasion, 
there were ‘Big Birthday Weekend’ Raspberry 
Jams all over the world. They took place at Raspberry Pi’s 
birthplace Cambridge, to my home town Philadelphia, all 
the way to Tokyo, and pretty much everywhere in between. 
Watching these worldwide Jams on Twitter was 
incredible and a reminder of how large, how widespread, 
and how enthusiastic the Raspberry Pi community is. The 
success of the Raspberry Pi over the last six years is due in 


We owe So much of the success 
of Raspberry Pi to the amazing 


community around it 


very large part to this community, which includes makers, 
developers, educators, tech geeks, engineers, gamers, 
artists, and many more. 

We’re a diverse group of people and we’re all over the 
elobe. But we have something in common. We know 
that affordable and accessible technology like Raspberry 
Pi is a powerful force in the world. Raspberry Pi brings 
computing and digital making to more people so that they 
can solve problems, express themselves, and have fun. 


Get Jammin’ 

There are some ways that all of us can ensure that this 
valuable community is growing and can sustain itself 

for many years ahead. First, if there’s a Jam happening 
near you, all you have to do is show up. Even if you don’t 
have anything to share, it’s a great opportunity to show 
your support and meet other community members. Even 
better, you can offer help to your local Jam organiser. 
Having a team of collaborators working on a Jam instead 
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MATT RICHARDSON 


Matt Richardson is the Executive Director of the Raspberry 
Pi Foundation North America and author of Getting Started 
with Raspberry Pi. Contact him on Twitter @MattRichardson. 


» SHEERS To THE 
COMMUNITY 


Matt Richardson’s take on ensuring community growth for years to come 


of a single individual makes a huge difference in the 
quality and sustainability of a recurring event like a Jam. 
If you don’t have a Jam near you, you can start one. 
You don’t need permission from us, but if you register 
your Jam, we can put it on the Jam map and make sure 
that other Raspberry Pi community members know 
about it. Don’t be intimidated by the big Jams you may 
have seen online or in The MagPi. A Jam often starts with 
just a few people getting together on a regular basis to 
share the projects they’re making with Raspberry Pi. 


Join the forum 

Another way to support the Raspberry 

Pi community is to participate in the 
forum: raspberrypi.org/forums. Whether 
you’re sharing a project you made, asking 
questions, providing guidance to others, 
or just chatting in the off-topic area, it’s such a great 
way for our community to stay connected. And with 
over a million posts, the forum has become a massive 
knowledge base. 

The Raspberry Pi is a computer made for making. So 
sharing what you create with Raspberry Pi is a great 
way to recruit new members to join our community. 
Part of this is just showing off what Raspberry Pi is 
capable of. And if you’re sharing the steps to how you 
made your project, you’re contributing to the wealth 
of online knowledge about Raspberry Pi in addition to 
empowering others to make. 

We owe so much of the success of Raspberry Pi and 
the Raspberry Pi Foundation to the amazing community 
around it. When you participate in the community by 
eoing to Jams, engaging in the forums, and sharing 
what you make, you’re helping to make sure that it will 
be around for a long time. Here’s to another six years of 
this kick-ass community! 
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THE Official 
RASPBERRY PI 
3EGINNER'S BOOK 


THE EASY WAY! 


Pi Zero W computer 


Official case with three covers 
USB and HDMI adaptors 

8GB Micro SD card 

116-page beginner’s book 
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Sa 7 ee ae Bad ee 


A Wiley Brand 


t) 


Build your own credit card 
sized computer 


Get started with programming 
Set up a Media Center 
Make simple electronic circuits 


Raspberry Pi board and case 
Power supply and HDMI cable 
Pre-Programmed Memory Card 
Over 49 electronic Parts 
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Available in Europe 
Available for worldwide shipping at: through RS Components 


$389” £69°° 


US DOLLARS EXCLUDING VAT 


Raspberry Pi is a registered trademark of the Raspberry Pi Foundation. 
For Dummies and the Dummies Man logo are trademarks or registered 
trademarks of John Wiley & Sons, Inc. Used under license. RS logo is 

a registered trademark of RS Components Ltd, Canakit is a registered 
trademark of Cana Kit Corporation. 
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